canon: Discernment Transfer Ladder method + rulebook-transfer evidence (COO probe)

[git-repo-auth]

Two portable-governance items from the 2026-06-30 COO distillation session. Proposal — models-do-not-mutate-canon; ratify the exact text.

Adds canon/methods/discernment-transfer-ladder.md — the empirical method that operationalizes rulebook-transfer (reference + held-out truth → measure on two axes → write the missing discernment down → re-run + regression-guard the reference → train/test on unseen cases → stop when a capability won't transfer). Frontmatter routes target_repo: outcomes-driven-development.

Edits canon/principles/rulebook-transfer.md — appends a bounded second probe to the Evidence section: down-tier execution to Haiku reaches ship-grade under an explicit lens (articulability ladder observed v1→v5); first data on the chain arm of star-vs-chain (mid-tier stewardship transfers but is lossy; frontier authoring is surgical). Device tier still untested.

Full eval evidence: kirigami-mcp PR (cross-model fidelity run).

---

Note

Low Risk
Documentation-only canon changes with no runtime or auth code paths; main effect is governance reasoning and how tier delegation is documented.

Overview
Adds canon/methods/discernment-transfer-ladder.md as a provisional Tier-2 method that turns rulebook-transfer into a measured loop (reference vs held-out truth, structural + semantic gaps, rulebook compensation, regression on the reference tier, unseen-case validation) and argues for a shallow-star authoring topology driven by human stewardship time. It also spells out how evaluation/ratification can move down-tier only as delegated, bounded stewardship aligned with models-do-not-mutate-canon.

Updates canon/principles/rulebook-transfer.md by appending a second probe (COO canon, 2026-06-30) to the Evidence section: stronger down-tier execution when lenses are explicit (Haiku v1→v2 compensation), plus first chain-arm data on stewardship (mid-tier fixes are lossy vs frontier authoring), with device tier and full star-vs-chain resolution still open.

^{Reviewed by Cursor Bugbot for commit 00009ab. Bugbot is set up for automated code reviews on this repo. Configure here.}

[github-actions]

Canon Quality — Frontmatter Schema ✅

All 49 file(s) in writings/ conform to klappy://canon/meta/frontmatter-schema.

_{Validator: scripts/validate-frontmatter.py · Canon: klappy://canon/constraints/frontmatter-validation-before-merge · Run: #308}

[github-actions]

Canon Quality — Homepage Surfacing ✅

49 essay(s) scanned. Soft report — never blocks; the hard field gate is the Frontmatter Schema job.

All published essays resolve to the homepage feed.

_{Report: scripts/surfacing-report.py · Canon: klappy://canon/constraints/frontmatter-validation-before-merge}

[github-actions]

Canon Quality — P0010 Retrieval-Readiness ⚠️

Soft report for klappy://canon/constraints/retrieval-disclosure-contract. 683 files scanned. Never blocks — informational until the corpus is ready to enforce.

• Blocking-class findings: 15 (structural fields the contract would filter on)
• Warnings: 0 (kind resolves to unknown)
• Informational: 13 (exempt templates/archive/drafts)

Kind distribution: {'essays': 51, 'canon': 231, 'apocrypha': 38, 'docs': 298, 'journals': 59, 'unknown': 6}
Kind source: {'path': 551, 'frontmatter': 126, 'none': 6} (frontmatter-primary, path-secondary)
Default-include visibility: 580 visible, 103 hidden (journals/apocrypha/unknown)

By rule: {'audience-invalid': 2, 'exposure-missing': 5, 'tier-missing': 5, 'tier-invalid': 7, 'fm-missing': 3, 'kind-unresolvable': 6}

These are not schema violations (see the Frontmatter Schema job for those on writings/). They are corpus-readiness signals for the retrieval contract: invalid/missing audience, exposure, tier, and docs whose kind cannot be resolved. Fix in a corpus-cleanup PR before the contract flips to enforcing. See the retrieval-readiness-findings artifact for the full list.

_{Validator: scripts/audit-retrieval-readiness.py · Constraint: klappy://canon/constraints/retrieval-disclosure-contract · Run: #308}

[github-actions]

Canon Quality — oddkit_audit ✅

No dead klappy:// references or legacy link patterns found in writings/. 51 files scanned.

_{Spec: klappy://docs/oddkit/specs/oddkit-audit · Workflow: .github/workflows/canon-quality.yml · Run: #308}