map-specs

Generates or updates a numbered spec-document set that becomes the source of truth an agent obeys when writing code. Produces: - docs/00-index.md — router index - docs/NN-topic.md — numbered spec files (100–400 lines each) - docs/decisions/ — Architecture Decision Records (ADRs) - docs/spec-compliance-plan.md — backlog of code that doesn't match canon When code is inconsistent, picks the canonical rule by convergence (the most common implementation wins) and logs every out-of-line occurrence to the compliance plan. Detects existing specs, diffs them against the code, fixes drift. ADRs are append-only. Writes docs only — never edits application code.