E0009: Triangle of Yaps — communication canon for entry-layer presentation

[klappy]

What this adds

Three new documents bringing the Triangle of Yaps framework into Klappy.dev canon.

canon/meta/triangle-of-yaps.md

Governance doc mapping the Triangle's three corners (T or T / M-A-E-S / A or N) to the ODD creed and four axioms. Defines the engagement-versus-proof tension and its resolution: the Triangle is the entry point, not the destination. The A-or-N corner is the threshold — it points to where the proof lives, not the proof itself. Includes the creed/axiom mapping table, worked podcast and essay applications, and a named retraction condition. Stability: experimental.

writings/the-triangle-i-found-while-scrolling.md

Public essay: origin story of finding the framework on Instagram, mapping it onto existing methodology as a new presentation layer (not a replacement), and handing the reader the lens. Guide posture throughout — reader is the hero. Includes the 'door not house' resolution of the engagement-vs-proof tension. Stability: draft (flip to stable on publish).

canon/methods/triangle-pass.md

Operational method for the entry layer. Five-move pass: name the one thought, open on the audience's stake, one illustration, point the door at real proof, stop before proving. Governs the weekly audio overview and any topic introduction. Includes the 7-point production checklist, named counter-examples (skeptical/adversarial audiences, already-committed audiences), and a retraction condition. Stability: experimental.

Epoch

E0009

Derives from

• canon/values/axioms.md
• canon/values/orientation.md
• canon/meta/writing-canon.md
• canon/constraints/guide-posture.md

Source

Framework borrowed from @iamjadenly (Triangle of Yapping). Credit given in both the canon doc (frontmatter source: field) and the public essay body.

---

Note

Low Risk
Documentation-only governance and a draft public essay; no executable or security surface, though new governs fields will shape future content reviews.

Overview
This PR adds three E0009 documents that introduce the borrowed “Triangle of Yaps” framework into klappy.dev as presentation-layer canon, layered on (not above) the Writing Canon, guide posture, and axioms.

canon/meta/triangle-of-yaps.md defines the three corners (T or T, M-A-E-S, A or N), maps them to the creed and axioms, and positions the triangle as an engagement rule for single units (segments, essays, sections)—with explicit subordination to progressive disclosure. It adds the engagement vs. proof tension and the door-not-house resolution (entry layer hooks; proof lives one level down), recursion across scales, podcast/essay guidance, constraints, retraction conditions, and a pre-publish checklist.

canon/methods/triangle-pass.md operationalizes that for the entry layer: a five-move pass (one thought, audience stake first, one illustration, point to real proof, stop before proving), weekly audio overview structure, the requirement that doors open on reachable proof, audience exceptions (skeptical vs. already committed), and a production checklist.

writings/the-triangle-i-found-while-scrolling.md is the public draft essay—origin story, reader-as-hero framing, practical three-question filter, door-not-house for readers, and credit to @iamjadenly—with klappy:// links back to canon.

All three are marked experimental (canon) or draft (essay); no runtime, auth, or build changes.

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

[github-actions]

Canon Quality — Frontmatter Schema ✅

All 42 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: #183}

[github-actions]

Canon Quality — oddkit_audit ✅

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

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

[github-actions]

Canon Quality — P0010 Retrieval-Readiness ⚠️

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

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

Kind distribution: {'essays': 43, 'canon': 167, 'apocrypha': 38, 'docs': 287, 'journals': 110, 'unknown': 6}
Kind source: {'path': 645, 'none': 6} (frontmatter-primary, path-secondary)
Default-include visibility: 497 visible, 154 hidden (journals/apocrypha/unknown)

By rule: {'audience-invalid': 2, 'exposure-missing': 5, 'tier-missing': 5, 'tier-invalid': 7, '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: #183}