P0003 (accept + execute): reframe-before-trimming method (new tier-2 canon doc)

[klappy]

What this PR does

Combined acceptance + execution of promotion P0003 — adds a new tier-2 method doc for the diagnostic move during MCP tool-surface refactoring.

Acceptance (1 file)

• docs/promotions/P0003-reframe-before-trimming.md
  • promotion_status: proposed → accepted
  • Tags array "proposed" → "accepted"
  • Status section header → accepted (2026-05-05)
  • Review Notes filled

Execution (1 file, NEW)

• canon/methods/reframe-before-trimming.md (new tier-2 method doc, 91 lines)
  • Frontmatter:
    • tier: 2, audience: canon, status: active
    • derives_from: doing-less-enables-more, vodka-architecture, kiss-simplicity-is-the-ceiling
    • complements: pivot-on-inversion
  • H1 # Reframe Before Trimming
  • Blockquote: "When an MCP server's tool surface feels bloated, the bloat is usually in the frame the surface implies, not in the tool count. Reframe first; the trim follows mechanically."
  • Sections: When This Method Applies / The Method (4-step procedure) / Failure Mode / Receipts / Relationship to Adjacent Canon

Writing-canon check

Followed the precedent of canon/methods/pivot-on-inversion.md (the doc named in P0003's complements field): H1 + blockquote + descriptive headers, no separate ## Summary section. The blockquote carries the compressed argument per writing-canon's blockquote test. All frontmatter values use native YAML types per frontmatter-schema.

Position in the 8-proposal sweep

#	ID	Status
1	P0009	PR #167
2	P0001	PR #168
3	P0008	PR #169
4	P0007	PR #170
5	P0006	PR #171
6	P0003	this PR ← first of three new-doc proposals
7	P0004	next — docs-proxy canon-as-tool pattern (new doc)
8	P0005	queued — async-by-default principle (new doc)

DoD

• Proposal frontmatter promotion_status flipped
• Review Notes filled
• New canon doc created at the path specified by the proposal
• Frontmatter follows frontmatter-schema (native YAML types)
• Doc structure follows precedent of an existing tier-2 method doc
• H1 present, blockquote present, descriptive headers

---

Note

Low Risk
Low risk: documentation-only changes that add a new canon method page and mark the corresponding promotion as accepted; no runtime or behavioral code is affected.

Overview
Adds a new tier-2 canon method doc, canon/methods/reframe-before-trimming.md, capturing a diagnostic workflow for MCP tool-surface refactors (reframe the server’s job first, then trim tools mechanically).

Updates docs/promotions/P0003-reframe-before-trimming.md from proposed to accepted, adjusting tags/status and filling in the Review Notes to record the decision and link the executed canon doc.

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

[github-actions]

Canon Quality — oddkit_audit ✅

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

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