doc-auditlisted

# Doc Audit One-shot audit of `ccsm` project docs against current code. Produces a triage list, not edits. ## Scope **Audit these (the live, code-derived docs):** - `README.md` - `docs/reference/*.md` — all files - `docs/superpowers/plans/*.md` — all files - `docs/status/STATUS.md` - `docs/attach-redesign.html` - `DEBT.md` **Skip these (frozen, archived, or time-stamped snapshots — do NOT touch):** - `docs/mvp-design.md` (marked frozen in `docs/README.md`) - `docs/design-system.md` (marked locked) - `docs/archive/**` - `docs/dogfood/**` - `docs/eval/**` - `docs/status/post-migration-gap-triage-*.md` (dated snapshot) - `docs/reference/ui-ux-pro-max-audit-*.md` (dated snapshot) - `RELEASE_NOTES_v*.md` - `CONTRIBUTING.md`, `SECURITY.md`, `LICENSE` - Anything under `node_modules/`, `dist/`, `build/` If a doc filename contains a date (`YYYY-MM-DD`) or lives under `archive/`, `dogfood/`, `eval/` — it's a snapshot, skip it. ## Method For each in-scope doc: 1. **Read the doc fully.** 2. **Extract concrete claims** that can be checked against code: - Named files/paths (`src/foo/bar.ts`) - Function/class/symbol names - CLI flags, config keys, env vars - Described behaviors / flows / invariants - Architecture diagrams referencing real modules 3. **Verify each claim against current code** — Grep/Glob/Read the named symbols and paths. 4. **Assign one verdict** (and only one): | Verdict | Meaning | |---|---| | **OK** | Claims match code. No action. | |