skills/repo-scout/assets/finding.template.json

{
  "_note": "Template only. Replace placeholders from actual evidence; do not publish this as a real finding.",
  "id": "<stable-id>",
  "kind": "<defect|risk|test-gap|maintainability|opportunity|docs>",
  "title": "<specific outcome>",
  "component": "<module>",
  "priority": "<P0|P1|P2|P3>",
  "priority_reason": "<impact and urgency>",
  "evidence_level": "<E0|E1|E2|E3>",
  "snapshot": {
    "commit": "<actual commit or unavailable>",
    "dirty_state": "<observed>"
  },
  "locations": [
    {
      "path": "<observed relative path>",
      "symbol": "<observed symbol>",
      "line_range": "<actual range or unavailable>"
    }
  ],
  "expected_contract": "<requirement/invariant with source>",
  "preconditions": [],
  "evidence": [],
  "impact": "<consequence>",
  "counterchecks": [],
  "uncertainties": [],
  "proposed_fix": "<not an implemented change>",
  "acceptance_criteria": [],
  "verification": {
    "status": "not_run",
    "command": null,
    "cwd": null,
    "environment": null,
    "exit_code": null,
    "actual_output": null
  },
  "effort_estimate": "<estimate and assumptions>",
  "change_risk": "<rationale>",
  "dedup": {
    "status": "not_checked",
    "sources": []
  },
  "publication_authorized": false
}