cli-audit-synclisted

> **Optimization:** This skill uses on-demand loading. Heavy content lives in `references/` and is loaded only when needed. > **Language rule:** Skill instructions are written in English. When generating user-facing output, detect the project's primary language (from README, comments, docs, commit messages) and produce the report in that language. If the project is bilingual, ask the user which language to use before proceeding. # Audit Sync — Documentation-Code Coherence Verifier Detect every place where documentation says one thing and the code says another. > "A stale diagram is worse than no diagram. A README with wrong commands is worse than no README." ## Core Principle **Documentation is a contract with the reader.** Every statement in docs is an implicit promise: "this is true right now." This skill finds broken promises. **Gotchas** — read `../../gotchas.md` before producing output to avoid known mistakes. ## Three-Layer Verification | Layer | Style | What it checks | Severity focus | |-------|-------|---------------|----------------| | **Layer 1 — Structural** | lychee-style | Internal links, anchors, images, code file refs, imports | Broken refs | | **Layer 2 — Semantic** | DocPrism/Swimm | Module/function/type names, endpoints, CLI flags, env vars, versions | Stale names | | **Layer 3 — Executable** | Docs-as-Tests | Shell commands, install steps, code snippets, Mermaid diagrams, **demo kits** (`docs/demos/**/DEMO.md`: each beat's command vs its declared