canon: Director's Chair vision — captain-approved thin overview

[klappy]

Summary

• Persists the captain-approved consolidated vision (director's-chair posture, six-layer substrate stack, CDO/Otto seat, vodka-architecture governance spine, L6 economy, four 2026-07-09 rulings) as canon/the-directors-chair-vision.md — a thin overview for the CDO (Otto) and other agents to orient from.
• Provenance appendix (Bee conversation IDs + canon threads) preserved intact as the unfold-map for drilling into full detail.
• Canon 0.39.0 → 0.40.0 with changelog entry and release notes per governance-change-discipline.md. No epoch bump — this document synthesizes existing E0009/E0010 canon rather than shifting posture.

Test plan

• Frontmatter matches canon/meta/frontmatter-schema.md (audience: canon, all 8 universal fields present)
• Provenance appendix carried over verbatim from the captain-approved source draft
• Changelog + release notes added per governance-change-discipline four-marker requirement

Captain-approved content; landing directly per delegated authority for reversible, already-approved canon changes.

🤖 Generated with Claude Code

---

Note

Low Risk
Documentation-only canon addition with version/changelog/release-note markers; no runtime, auth, or epoch posture change.

Overview
Adds a captain-approved, tier-2 canon orientation doc (canon/the-directors-chair-vision.md) that pulls the whole-program vision into one thin frame: director's-chair posture, six-layer stack, CDO/Otto seat, policy-not-code governance, L6 economy, and vodka-architecture discipline. It cross-references existing canon rather than redefining it, and keeps depth in a provenance appendix (Bee conversation IDs + canon thread names) as the unfold-map for drill-down.

Records four 2026-07-09 captain rulings in canon: naming deferred/split from layers; Otto as CDO/human-interface among many (mostly headless) crew; meter before Braigslist; needs-first iterative build with full vision in focus.

Pack governance markers: Canon 0.39.0 → 0.40.0 in canon/CHANGELOG.md, plus release notes at docs/oddkit/release-notes/2026-07-09-directors-chair-vision.md. No epoch bump — synthesis of existing E0009/E0010 material, not a posture shift.

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

[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 — 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: #318}

[github-actions]

Canon Quality — P0010 Retrieval-Readiness ⚠️

Soft report for klappy://canon/constraints/retrieval-disclosure-contract. 685 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': 232, 'apocrypha': 38, 'docs': 299, 'journals': 59, 'unknown': 6}
Kind source: {'path': 553, 'frontmatter': 126, 'none': 6} (frontmatter-primary, path-secondary)
Default-include visibility: 582 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: #318}

[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: #318}