Skip to content

canon: sweep DOLCHEO+H residue from active surfaces (P0009 enforcement)#190

Merged
klappy merged 1 commit into
mainfrom
claude/dolcheo-residue-sweep
May 10, 2026
Merged

canon: sweep DOLCHEO+H residue from active surfaces (P0009 enforcement)#190
klappy merged 1 commit into
mainfrom
claude/dolcheo-residue-sweep

Conversation

@klappy
Copy link
Copy Markdown
Owner

@klappy klappy commented May 10, 2026

Summary

Surgical sweep of the DOLCHEO+H residue P0009 named as an explicit anti-pattern but never cleaned up. Two active surfaces fixed:

  1. canon/constraints/mode-transitions-require-encoded-handoff.md (Tier 1) — the worst leak. Three uses of DOLCHEO+H + three links to a superseded URI (klappy://docs/oddkit/proactive/oldc-h-vocabulary), plus the same superseded URI in complements frontmatter. Every session reading mode-transition canon was being told the anti-pattern was governance, then sent to a superseded vocabulary doc when it tried to follow the link. Also corrected the artifact-list ordering to match DOLCHEO and added the missing opens.

  2. writings/reverse-engineer-the-future.md (published essay) — line 256 used "DOLCHEO+H artifacts." The seven-item expansion was already DOLCHEO-shaped; only the bracketing acronym needed correction.

Verification

$ grep -rn "DOLCHEO+H" canon/ writings/ docs/ --include="*.md" | grep -v anti-pattern
(empty)

$ grep -rn "klappy://docs/oddkit/proactive/oldc-h-vocabulary" canon/ writings/ --include="*.md"
canon/definitions/dolcheo-vocabulary.md:243: [OLDC+H (superseded)](...) — the original five-type vocabulary

The remaining link is intentional: it's the supersession breadcrumb in the DOLCHEO vocabulary doc itself, explicitly labeled.

Out of scope (flagged separately)

  • writings/from-passive-to-proactive.md — uses "encode OLDC+H" twice in recollective passages about historical practice; correctly historical, not retroactively rewritten here.
  • canon/bootstrap/model-operating-contract.md — already correct on main. The reason it appeared stale earlier in session was that the oddkit MCP R2 cache was serving an older revision. That is an oddkit cache-invalidation concern, not a canon residue concern.
  • odd/ledger/ and odd/handoffs/ entries using OLDC+H or DOLCHE — historical record at write time.
  • Project-level instruction files (this Claude Project's own instructions) — outside the canon repo; operator action required.

Coupling note for PR #187

PR #187 ships its own version of canon/constraints/mode-transitions-require-encoded-handoff.md that has the same DOLCHEO+H bug. When PR #187 is rebased onto main after this merges, the rebase will conflict on this file and the resolution should keep the corrected version from this PR.


Note

Low Risk
Low risk documentation-only updates that rename terminology and update internal links; risk is limited to broken references if any downstream docs still expect the superseded URI.

Overview
Updates canon and essay text to remove the deprecated DOLCHEO+H terminology and the superseded klappy://docs/oddkit/proactive/oldc-h-vocabulary link.

The mode-transition constraint now references DOLCHEO (including the correct item ordering and opens) and points complements/in-text/See Also links to klappy://canon/definitions/dolcheo-vocabulary. The public essay similarly renames “DOLCHEO+H artifacts” to DOLCHEO while keeping the expanded list consistent.

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

P0009 named DOLCHEO+H as an explicit anti-pattern but never swept the
existing residue. This commit fixes the two active surfaces where the
malformed vocabulary was leaking:

1. canon/constraints/mode-transitions-require-encoded-handoff.md (Tier 1)
   - frontmatter complements: replace docs/oddkit/proactive/oldc-h-vocabulary.md
     with canon/definitions/dolcheo-vocabulary.md
   - body: 3 occurrences of DOLCHEO+H -> DOLCHEO
   - body: 3 links to klappy://docs/oddkit/proactive/oldc-h-vocabulary ->
     klappy://canon/definitions/dolcheo-vocabulary
   - corrected the artifact-list ordering in the journal-entry section to
     match DOLCHEO order (decisions, observations, learnings, constraints,
     handoffs, encodes, opens) and added 'opens' which had been missing

2. writings/reverse-engineer-the-future.md (published essay)
   - line 256: DOLCHEO+H artifacts -> DOLCHEO artifacts
   - the seven-item expansion was already DOLCHEO-shaped; only the
     bracketing acronym needed correction

The Tier-1 constraint was the worst leak: it was both using the anti-
pattern AND linking to a superseded URI on the same line, so every
session that fetched mode-transition canon read DOLCHEO+H as if it were
governance and could not even reach the corrected vocabulary doc by
following the link.

Out of scope for this PR (flagged for separate handling):
- writings/from-passive-to-proactive.md uses 'encode OLDC+H' in two
  recollective passages about historical practice; those are correctly
  historical and should not be retroactively rewritten
- bootstrap doc canon/bootstrap/model-operating-contract.md is already
  correct on main; oddkit MCP's R2 cache was serving a stale prior
  version, which is an oddkit cache-invalidation concern, not a canon
  residue concern
- many odd/ledger/* and odd/handoffs/* entries use OLDC+H or DOLCHE
  because that was the vocabulary at write time; they are historical
  record
@github-actions
Copy link
Copy Markdown

Canon Quality — oddkit_audit

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

Spec: klappy://docs/oddkit/specs/oddkit-audit · Workflow: .github/workflows/canon-quality.yml · Run: #97

klappy pushed a commit that referenced this pull request May 10, 2026
Same surgical fixes as PR #190 applied to this branch's working copies of the
two affected files, so the bug is gone here too and rebase-time conflict
resolution is unambiguous.

- canon/constraints/mode-transitions-require-encoded-handoff.md: 3x DOLCHEO+H
  -> DOLCHEO, 3x dead-URI links to klappy://docs/oddkit/proactive/oldc-h-vocabulary
  -> klappy://canon/definitions/dolcheo-vocabulary, frontmatter complement
  fixed, artifact ordering corrected and 'opens' added.
- writings/reverse-engineer-the-future.md line 256: DOLCHEO+H artifacts
  -> DOLCHEO artifacts.
klappy pushed a commit that referenced this pull request May 10, 2026
Same surgical fixes as PR #190 applied to this branch's working copies of the
two affected files, so the bug is gone here too and rebase-time conflict
resolution is unambiguous.

- canon/constraints/mode-transitions-require-encoded-handoff.md: 3x DOLCHEO+H
  -> DOLCHEO, 3x dead-URI links to klappy://docs/oddkit/proactive/oldc-h-vocabulary
  -> klappy://canon/definitions/dolcheo-vocabulary, frontmatter complement
  fixed, artifact ordering corrected and 'opens' added.
- writings/reverse-engineer-the-future.md line 256: DOLCHEO+H artifacts
  -> DOLCHEO artifacts.
@klappy klappy merged commit 7269164 into main May 10, 2026
2 checks passed
@klappy klappy deleted the claude/dolcheo-residue-sweep branch May 10, 2026 22: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.

1 participant