{
  "skill_name": "common-documentation",
  "evals": [
    {
      "id": 1,
      "prompt": "Add comments to this complex retry logic function that implements exponential backoff with jitter.",
      "expected_output": "Add JSDoc with @param, @returns, @example. Add inline comment explaining WHY jitter is added (prevents thundering herd), not WHAT the calculation does (code is self-explanatory). Remove any commented-out code — use git history instead.",
      "assertions": [
        { "type": "contains", "value": "why" },
        { "type": "contains", "value": "JSDoc" }
      ]
    },
    {
      "id": 2,
      "prompt": "Write a README for our new authentication microservice.",
      "expected_output": "README structure: (1) Mission — one-sentence purpose. (2) Prerequisites — exact runtime versions. (3) Installation — step-by-step commands. (4) Usage — copy-paste examples. (5) Known quirks and troubleshooting. Documentation ships with the feature, not after.",
      "assertions": [
        { "type": "contains", "value": "Prerequisites" },
        { "type": "contains", "value": "Usage" }
      ]
    },
    {
      "id": 3,
      "prompt": "I have TODO comments scattered throughout the code with no owner or ticket reference.",
      "expected_output": "Violation: orphan TODOs. Every TODO needs (owner) and linked ticket: TODO(username): Fix race condition in payment flow — JIRA-1234. Add FIXME with ownership for bugs. Delete any TODO that's more than 6 months old without a ticket — if it mattered, it would have a ticket.",
      "assertions": [
        { "type": "contains", "value": "TODO" },
        { "type": "contains", "value": "owner" }
      ]
    }
  ],
  "should_not_trigger": [
    "Optimize my database queries for better performance",
    "Set up a CI/CD pipeline with GitHub Actions",
    "Implement a rate limiter for the API"
  ]
}
