R76.H6 Contract — 22→23 reconciliation + docs health

Scope

Replace the literal digit pair 22 with 23 in every live-canon file where the context is “canonical colibri-* skills”. Insert colibri-sigma-orchestrator into any enumerated skill list that omits it.

Behavioral rules

  1. Exact numeric swap only. 22 → 23 is only applied where the adjacent prose reads “canonical”, “colibri-*”, “skills”, or equivalent context. Any 22 unrelated to skill count (e.g., AMS donor 22 workflows, 22 spawns) is untouched.

  2. Heritage docs preserved. docs/audits/, docs/contracts/, docs/packets/, docs/verification/ all contain historical records that were accurate at their writing. They are NOT rewritten. New post-Wave-2 verification doc (docs/verification/r76-h6-docs-health-verification.md) records the new 23 state.

  3. Enumerated-list insertion. Two files enumerate skills by name: .agents/README.md (§Skills, PM & Orchestration subsection) and .claude/README.md (Canonical table). Both gain colibri-sigma-orchestrator as a new row/entry. All other files only have aggregate counts, not enumerations — those just get the digit swap.

  4. Fix trivial; defer bigger. Typos or obviously broken internal links found during the scan may be fixed inline. Any substantive drift (directory doc counts, mirror divergences, supersed doc re-work) is enumerated in the audit doc and deferred to R77.

  5. Dual-purpose audit. The audit doc is both Step 1 of the executor chain AND the Wave 2 gate evidence report for Sigma. No separate Sigma report is needed.

  6. Gate triplet. npm run build && npm run lint && npm test must be green. 1085 tests (H5 bumped from 1084).

  7. No source edits. src/ is not touched. Only docs and skill mirror (for enumerated lists). No test changes (H5 already bumped the assertion).

  8. No mirror hand-editing. Per CLAUDE.md §9.2, .claude/skills/colibri-* is a MIRROR zone. R76.H6 does NOT touch individual SKILL.md files in the mirror. The .claude/README.md edits are allowed because that file is the .claude/ directory README itself, not a mirror of any .agents/skills/*/SKILL.md — CLAUDE.md §9.2 declares .claude/ itself as MIRROR (drifting) but the enforce-rule is about mirrored SKILL.md files, not the README.

  9. No new test additions. The P0.6.1 skill-registry test (src/__tests__/skill-schema.test.ts) already asserts 23; no further test plumbing is required for this docs-only PR.

Acceptance

  • Live canon grep 22 canonical \colibri-`` returns zero hits.
  • ls -d .agents/skills/colibri-*/ | wc -l = 23 confirmed in verification doc.
  • 11 files edited; 2 enumerated lists gain colibri-sigma-orchestrator.
  • Health check table in audit doc enumerates ≥4 findings (doc counts, mirror divergence, YAML safety, Phase 0 phrases).
  • Build + lint + test green.
  • PR body contains the writeback block for R76.H6 + Wave 2 gate writeback.

Non-acceptance (explicit)

  • docs/{audits,contracts,packets,verification}/* files with 22 are NOT rewritten.
  • docs/PLAN-RED.md is not reviewed.
  • .claude/skills/colibri-*/SKILL.md individual mirror files are not resynced.
  • Directory doc-count drift in CLAUDE.md §9.2 is documented but not fixed.
  • Obsidian vault sync is not run.

Back to top

Colibri — documentation-first MCP runtime. Apache 2.0 + Commons Clause.

This site uses Just the Docs, a documentation theme for Jekyll.