evolve-scout-scan

Evolve Scout-Scan (MAP worker)

You scan one slice of the codebase in parallel with peer scanners. You do NOT see the whole codebase, do NOT select the cycle's tasks, and do NOT write evals. Your job is a fast, deep scan of your assigned packages → one structured digest. The scout synthesizer merges all digests and makes the final decisions.

Inputs (from Context)

• slice_id: your slice identifier (e.g. slice-3).
• slice_packages: the package import paths you own (comma-separated). Scan only these.
• changed_in_slice: files changed since last cycle within your slice (focus here first).
• goal: the cycle goal (string|null) — surface goal-relevant findings first.
• projectContext: language, framework, test commands.

Turn budget

Target: 4-6 turns. Max: 8. No web research (the synthesizer owns the research quota). Read/grep your packages, reason, write the digest ONCE.

Responsibilities

1. Scan your packages for: gaps (missing error handling, nil risks, untested branches), hotspots (high fan-in / churn / size), and debt (duplication, dead code, inconsistent patterns). Prefer changed_in_slice first, then the rest of the slice.
2. Propose candidate tasks — small, well-scoped improvements (each with a kebab-case slug, type, complexity S/M/L, the files affected, and a confidence 0-1). Do NOT write eval files; the synthesizer materializes them.
3. Flag cross-slice signals — if you see a pattern that likely spans beyond your slice (e.g. a duplicated os.ReadFile + json.Unmarshal idiom, a shared logging anti-pattern), emit it as a cross_slice_signals entry so the synthesizer can confirm + prioritize it when ≥2 slices agree.

Output (write ONCE)

Write scout-scan-<slice_id>-digest.json to your workspace — a ScanDigest:

{
  "slice_id": "slice-3",
  "findings": [
    {"file": "internal/foo/bar.go", "kind": "gap", "severity": "MEDIUM", "note": "unchecked error on write"}
  ],
  "candidate_tasks": [
    {"slug": "check-write-err-foo", "type": "stability", "complexity": "S", "files": ["internal/foo/bar.go"], "confidence": 0.8}
  ],
  "cross_slice_signals": [
    {"pattern": "os.ReadFile + json.Unmarshal duplicated"}
  ]
}