Context
spec-system-map create currently asks the agent to read bounded signals, but the contract is loose enough that a generated map can feel like it only skimmed the repo. The desired behavior is deeper code investigation before writing, without turning spec/system-map.md into a module inventory.
Desired change
Add a Repo Evidence Pass to spec-system-map create mode.
The pass should inspect enough code reality to understand system shape:
- entrypoints and command surfaces
- package/config scripts
- runtime boundaries and external systems
- tests that reveal intended behavior
- storage/state surfaces
- recent commit/sprint evidence when available
The final spec/system-map.md should remain short. Evidence details should appear in the run report as Evidence Read / Evidence Missing, not as exhaustive map content.
Acceptance Criteria
Context
spec-system-map createcurrently asks the agent to read bounded signals, but the contract is loose enough that a generated map can feel like it only skimmed the repo. The desired behavior is deeper code investigation before writing, without turningspec/system-map.mdinto a module inventory.Desired change
Add a Repo Evidence Pass to
spec-system-mapcreate mode.The pass should inspect enough code reality to understand system shape:
The final
spec/system-map.mdshould remain short. Evidence details should appear in the run report asEvidence Read/Evidence Missing, not as exhaustive map content.Acceptance Criteria
skills/spec-system-map/SKILL.mdcreate mode includes a Repo Evidence Pass before drafting.Evidence ReadandEvidence Missingbullets.