Skip to content

enhance(spec-system-map): add deeper repo evidence pass before create #184

@sungjunlee

Description

@sungjunlee

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

  • skills/spec-system-map/SKILL.md create mode includes a Repo Evidence Pass before drafting.
  • The pass names the evidence classes agents should inspect.
  • Completion output for create mode includes concise Evidence Read and Evidence Missing bullets.
  • Quality checks continue to reject module inventories, endpoint lists, runbook commands, and temporary TODOs.
  • Existing eval prompts are updated or extended to catch shallow brownfield maps.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationenhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions