← ClaudeAtlas

doc-enforce-truthlisted

SDD documentation truth-check / source-of-truth enforcement. Runs Pass 8 (verification truth-check), Pass 9 (Implements-vs-AC cross-walk), Pass 10 (stale code-block detection), Pass 11 (content-preservation on trim), Pass 12 (stranger cold-read), Pass 15 (doc source-anchor truth-check, ALWAYS runs). Invoked conditionally by doc-enforce when Implemented REQ docs are touched OR scope=all.
nikolanovoselec/codeflare · ★ 24 · AI & Automation · score 71
Install: claude install-skill nikolanovoselec/codeflare
# Documentation Enforcement — Truth-check passes This skill cross-references documentation against source code, tests, and REQs to catch stale, mismatched, or lying prose. Invoked by `doc-enforce` (the spine) when Implemented REQ docs are touched or scope=all. ## Inputs - `diff`: git diff against base - `scope`: `all` | `diff` - `mode`: `interactive` | `auto` | `unleashed` - `src_globs`: from `sdd/config.yml` - `test_globs`: from `sdd/config.yml` ## Output Returns findings array + auto-fix actions. Writes evidence-count rows back to the spine's manifest: - `Pass 8 — Verification truth-check`: `ran (V fields, F files, M findings)` - `Pass 9 — Implements-vs-AC cross-walk`: `ran (I fields, M findings)` - `Pass 10 — Stale code-block detection`: `ran (B blocks, M findings)` - `Pass 11 — Content-preservation on trim`: `ran (T ops, M findings)` or `inert (no trim ops)` - `Pass 12 — Stranger cold-read`: `ran (T tasks, M findings)` or `ran (cached, hit on SHA <sha>)` - `Pass 15 — Doc source-anchor truth-check`: `ran (D docs, A anchors verified, V drift, O orphaned, U unanchored)` — ALWAYS runs, never inert **Layout-awareness.** Doc file discovery uses `documentation/lanes/**/*.md` and `documentation/decisions/**/*.md` when the nested layout exists; falls back to `documentation/*.md` and `documentation/decisions/*.md` on flat layout. ## Pass 8 — Verification truth-check For every `**Verification:** <test-file>` field, open the cited file and check: 1. The section's `**Implemen