Spec System Map

Create or amend spec/system-map.md, the high-level map of how the project is shaped. This is narrower than a generic ARCHITECTURE.md: it names project-wide structure, boundaries, flows, storage/external systems, invariants, and pointers to deeper docs.

Boundary

Use ../spec-charter/references/spec-axis.md as the shared file-boundary reference. This skill owns only spec/system-map.md: system shape, runtime boundaries, core flows, storage/external systems, invariants, and pointers.

Do not turn system-map.md into exhaustive module documentation, API reference, runbook, ADR log, or implementation notes. Demote subsystem detail to linked docs; promote only project-wide structure or invariants.

Mode Router

• create: use when spec/system-map.md is absent or the user asks for a first system map.
• amend: use when the file exists and the user asks to update architecture shape, boundaries, flows, invariants, or links.

When no mode is specified, route by file state. Create spec/ if needed.

Create Mode