Verify documentation health for the Colibri docs/ tree — link integrity, number accuracy, section index completeness, and Phase 0 reality compliance. Greek: α (alpha) — System Core. Use after doc commits, before doc PRs, or as a periodic health check.
Greek letter: α (alpha) — System Core ⚠ Phase 0 is 100% complete on non-deferred tasks (28/28 as of R75 Wave I, 2026-04-18). P0.5.1/P0.5.2 shipped as δ library-only stubs per ADR-005 §Decision. The Colibri repo now contains ~700 markdown files across 12 top-level directories (CLAUDE.md §9.2 is authoritative; the old
docs/inventory-r74-2.mdwas absorbed into §9.2 and removed in R75). Any number claim in this skill that disagrees with the live grep is a bug — run the grep before asserting.Post-Phase-0 reality stamp (2026-04-19, R76.H3). Some tool names below mark donor-era deferred capabilities; the Phase 0 shipped 14-tool surface is authoritative — see ADR-004.
Use this skill to verify the Colibri docs/ tree is internally consistent, numerically accurate, fully indexed, and free of stale donor-era claims.
E:\AMS\temp\sync-full.bat)Count markdown files in the four axes of the repo and cross-check against the canonical inventory:
find .agents docs .github assets projects -name '*.md' -type f | wc -l
find . -maxdepth 1 -name '*.md' -type f | wc -l
Cross-check against CLAUDE.md §9.2, which holds the 12-folder zoned manifest. The manifest splits counts by zone (CANON · HERITAGE · MIRROR · SCRATCH · VENDOR).
Excludes (not in the docs count):
.venv-tools/ — VENDOR (Python package residue).worktrees/ — SCRATCH (generated feature worktrees)temp/ — SCRATCH (round staging, gitignored except temp/README.md)node_modules/ — vendor_vault/ — vault planning zoneFor each section directory under docs/, confirm index.md links every child file. Orphan files are an auto-fail.
docs/concepts/index.md — must list all 15 Greek-letter concept docs (α β γ δ ε ζ η θ ι κ λ μ ν ξ + one reserved slot). See CLAUDE.md §10 and colibri-greek-nav.docs/spec/index.md — must cover the 19 active protocol specs (S01–S19 as of R74). Count the s[0-9]*-*.md files and cross-check against the index.docs/guides/index.md — must cover tutorials, implementation guides (including docs/guides/implementation/task-breakdown.md and the nine p0.*-*.md task prompts), and reading order.docs/reference/index.md — must cover the 49 extractions in docs/reference/extractions/ plus the component-map, glossary, and Greek vocabulary.docs/architecture/decisions/ — confirm each ADR is linked from a parent index (ADR-001 through ADR-005 at minimum, including ADR-005 which defers δ Model Router to Phase 1.5).Flag any file present on disk but missing from its section index as an orphan.
Verify these claims match the live repo state — do not trust cached or historical values.
| Metric | Current canonical value | How to verify |
|---|---|---|
| Total .md files | 656 (R74.2 baseline) | find command in Step 1 |
| Top-level directories | 12 (CLAUDE.md §9.2) | ls -d */ at repo root |
| Root .md files | 6 (CANON) | find . -maxdepth 1 -name '*.md' |
| Greek concepts | 15 (α–ν + ξ; ο reserved) | ls docs/concepts/[a-z]-*.md | wc -l |
| Phase 0 tools | 19 (S17 §1, Option C) | Read colibri-mcp-server/references/tools.md §3 |
| Runtime modes | 4 (FULL, READONLY, TEST, MINIMAL) | Read docs/spec/s17-mcp-surface.md |
| α middleware stages | 5 (tool-lock → schema validate → audit enter → dispatch → audit exit) | Read docs/concepts/alpha-system-core.md |
| Phase 0 code | none — src/ does not exist yet | test ! -d src && echo "OK: src/ does not exist" |
Critical: the Phase 0 code columns are all targets, not files. Do not count "lines of TypeScript" or "number of middleware files" — they do not exist. If a doc claims otherwise, it is a bug and must be corrected.
Scan for [text](path) patterns and verify the target file exists. For each relative path found, confirm it exists relative to the source file directory. Broken links are an auto-fail.
grep -rE '\]\(\.\.?/[^)]+\.md\)' docs/ --include='*.md' -l
# Then validate each extracted link with Read or test -f
Search for known stale patterns that survived the donor era and must never reappear in canonical docs:
| Pattern | Why it's stale | Replacement |
|---|---|---|
484 tools, ~480 tools, 490 tools, 493 tools | Donor AMS tool count | 19 tools (Phase 0) |
78 tables, 82 tables, 85 tables | Donor AMS schema count | Phase 0 schema is P0.2.2 target |
11 middleware | Donor middleware stage count | 5 middleware stages |
src/server.js | Donor entry point (deleted R53) | src/server.ts (P0.2.1 target) |
src/controllers/ | Donor layout | src/domains/*/tools.ts (Phase 0) |
src/intelligence/ | Donor δ Model Router | Deferred to Phase 1.5 per ADR-005 |
AMS_DB_PATH, AMS_LOG_LEVEL, AMS_MODE, AMS_ROOT, AMS_WATCH_MODE | Donor env namespace | COLIBRI_DB_PATH, COLIBRI_LOG_LEVEL, COLIBRI_MODE, etc. |
skill_get, skill_reload | Phase 1, not Phase 0 | Phase 0 has skill_list only |
agent_spawn, agent_status, agent_list | Phase 1.5 per ADR-005 | Not registered in Phase 0 |
gsd_*, unified_*, roadmap_*, watcher_*, observe_*, memory_*, context_* | Donor tool families | Not in Phase 0 (see colibri-mcp-server/references/tools.md §5) |
Phase 0 note: The
gsd_*,unified_*,roadmap_*,watcher_*,observe_*,memory_*, andcontext_*families in the final row are donor-era and not in the Phase 0 14-tool surface — see ADR-004 R75 Wave H amendment.
Any match must either be (a) corrected or (b) already wrapped in an explicit heritage callout (> ⚠ Heritage..., > **Not in Phase 0**, or inside a <details> heritage block). Heritage-quarantined mentions are allowed and intentional.
Produce a summary covering:
| Issue | Fix |
|---|---|
| Orphan doc | Add link to parent section index |
| Broken link | Correct the path or remove the link |
| Stale donor number | Replace with Phase 0 value from Step 3 table, or wrap in heritage callout |
| Donor tool name outside callout | Add > ⚠ Heritage banner or replace with Phase 0 equivalent |
| Missing concept | Add to docs/concepts/index.md |
src/server.js reference | Replace with src/server.ts (Phase 0 target, P0.2.1) |
docs/index.md — master indexCLAUDE.md §9.2 — 12-folder zoned manifestdocs/concepts/index.md — 15 Greek conceptsdocs/reference/greek-vocabulary.md — full Greek vocabularycolibri-mcp-server/references/tools.md — Phase 0 tool reference