Skip to content

P0009 (accept + execute): DOLCHEO+H anti-pattern callout in dolcheo-vocabulary#167

Merged
klappy merged 1 commit intomainfrom
claude/p0009-dolcheo-anti-pattern
May 5, 2026
Merged

P0009 (accept + execute): DOLCHEO+H anti-pattern callout in dolcheo-vocabulary#167
klappy merged 1 commit intomainfrom
claude/p0009-dolcheo-anti-pattern

Conversation

@klappy
Copy link
Copy Markdown
Owner

@klappy klappy commented May 5, 2026

What this PR does

Combined acceptance + execution of promotion P0009 — the explicit anti-pattern callout for the malformed string DOLCHEO+H.

Acceptance (1 file, +5/-7)

  • docs/promotions/P0009-dolcheo-not-dolcheo-plus-h-anti-pattern.md
    • promotion_status: proposedaccepted
    • Tags array "proposed""accepted"
    • Status section header → accepted (2026-05-05)
    • Review Notes filled with operator decision

Execution (1 file, +21/-0)

  • canon/definitions/dolcheo-vocabulary.md
    • New section ## Anti-Pattern — Do Not Write "DOLCHEO+H" inserted between ## Discoverability and ## See Also
    • Three-bullet rationale (doubled H, OLDC+H residue, propagation mechanism)
    • Sub-section for handling older artifacts that contain the malformed form
    • Receipts citing the propagation source (PTXprint PR Add Anti-Cache Lying constraint and content-addressed storage implementation #30 ledger) and the 2026-05-03 slate-authoring session

Why P0009 first

This is the first of 8 stuck proposed promotions sitting behind P0002's just-merged chain (PRs #163#165#166). Triage order:

  1. P0009 ← this PR — operator-stated frustration ("resurfacing every conversation"); smallest possible execution surface
  2. P0001 — oldest backlog item; foundational completion-claims-require-artifacts
  3. P0008 — fresh-validator DOLCHEO ledger convention (affects current release-validation-gate workflow)
  4. P0007 — DoD as agent-observable behaviors
  5. P0006 — vodka boundary enumeration
  6. P0003 — reframe-before-trimming method
  7. P0004 — docs-proxy canon-as-tool pattern
  8. P0005 — async-by-default-for-long-running-tools principle

Combined-PR note

P0002 separated acceptance (PR #165) from execution (PR #166). This PR combines them to halve review burden across the 8-proposal backlog. If you'd rather have them split (matching P0002's pattern exactly), say so and I'll re-do the remaining 7 as paired PRs.

DoD

  • Proposal frontmatter promotion_status flipped to accepted
  • Review Notes block filled with reviewer / decision / date / notes
  • Canon edit text matches the proposed language in P0009 §"Proposed Language" verbatim
  • Insertion point matches the proposed section position ("near the end, before ## See Also")
  • No other canon docs touched

Verification after merge

oddkit_search for "DOLCHEO+H" should surface this new anti-pattern section ahead of the OLDC+H legacy doc and any older ledger references.


Note

Low Risk
Low risk documentation-only change that clarifies correct DOLCHEO terminology and updates a promotion record; no runtime or workflow logic is modified.

Overview
Adds an explicit anti-pattern section to canon/definitions/dolcheo-vocabulary.md stating that DOLCHEO+H is malformed, explaining why it appears (legacy OLDC+H residue) and how to treat/correct older artifacts, with receipts.

Updates promotion P0009 to accepted by flipping frontmatter (tags, promotion_status), marking status/date, and filling in review notes to record the acceptance decision.

Reviewed by Cursor Bugbot for commit 59e6860. Bugbot is set up for automated code reviews on this repo. Configure here.

…ocabulary

Acceptance:
- Flip docs/promotions/P0009 promotion_status: proposed -> accepted
- Update tags array ("proposed" -> "accepted")
- Fill Review Notes with operator decision (klappy, 2026-05-05)

Execution:
- Append "## Anti-Pattern — Do Not Write 'DOLCHEO+H'" section to
  canon/definitions/dolcheo-vocabulary.md, between Discoverability and See Also
- Section explains why the +H suffix is malformed (already in DOLCHEO acronym),
  identifies the propagation source (PTXprint PR #30 ledger), and tells future
  readers how to handle older artifacts that contain the malformed form

This is one of seven stuck proposals (P0003-P0009 batch from PR #164, plus
P0001) that landed as 'proposed' but were never accepted/executed. P0002 just
finished its full promotion chain (PRs #163 -> #165 -> #166); this is the
first of the queued backlog, prioritised because the operator named it as
recurring frustration.
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 5, 2026

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: #38

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants