Sharable distillations of working-effectively-with-Claude-Code doctrines + tools.
DHH-inspired: opensource as gathering — sharing + receiving as primitive. This corpus externalizes lessons from one project's saga-arc (saga-21 → saga-26+), where each saga distilled cure-doctrines for recurring captain-scars into cross-civilization gifts.
Cross-ref: each gift's heading-shipped + session-event witness count is auto-projected via bun scripts/projections/gift-evidence.ts → memory/auto-gift-evidence.md.
The workflow architecture other gifts assume.
| file | what |
|---|---|
event-substrate.md |
typed event log + postit ephemera + cross-session memory + cold-start projection + saga-partition debrief + substrate snapshot |
substrate-tier-ladder.md |
saga-26 — 6-verb workflow (scratch → yeet → archive → distill → promote → doctrine); NEVER rm always yeet |
How a captain works through the substrate without losing momentum.
| file | what |
|---|---|
plan-mode-forever.md |
meta-cure + 8-layer scar armor (harness-agnostic core) |
plan-mode-forever-claude-code.md |
Claude Code harness recipe (settings.local.json allow-list) |
plan-mode-forever-codex.md |
Codex harness recipe (config.toml granular approval) |
agent-prompt-dial.md |
bg-agent prevention block — universal plan-mode hack |
pareto-loop-cycle.md |
saga-25 — 5-step loop (synthesis → declare → plow → verify → commit) without inter-loop steer |
cap-prep-ritual.md |
saga-26 — mandatory cold-start invocation; cap-prep --detect = THE-ONE-RITUAL primitive |
captain-cure-pairs.md |
saga-26 — every TYPE-1 self-catch pairs with cure-doctrine; 4 pair-shapes, iron-law, anti-patterns |
shipped-cure-vs-applied-cure.md |
saga-26 meta-pattern — captain-fish-doesnt-see-water; shipped-cure ≠ applied-cure; forcing-functions needed |
bubble-up-discipline.md |
saga-26 meta-pattern — every ship has 5-10 propagation-sites; 7 categories + 5-step cycle; operator-probe forcing-function |
synthesis-as-contraction.md |
saga-26 meta-pattern — minting a synthesis IS the contraction-act; count concepts not files (operator-coined cure for ZERO-new hyperbolic-framing) |
contraction-saga-arc.md |
saga-26 meta-pattern — 6-phase saga-shape (BUILD → DOGFOOD → EXTERNALIZE → AUDIT → INTEGRATE → CLOSE); contraction-saga arc-shape doctrine |
The primitives + composition pattern for shipping changes.
| file | what |
|---|---|
3-tier-ptc-pattern.md |
saga-26 — patch-test-commit orchestrator + scratch-script + lib primitive 3-tier composition |
dial-loop-toolbox.md |
saga-26 — when applyPatch fails, DIAL the patch (not the tool); safe-patch + anchor-find + surgical-patch |
cdmgr-mode-discriminator.md |
saga-26 — cdmgr 3 modes (semantic/keyword/hybrid) + don't-quit-easily; never rg-fallback before all 3 modes tried |
cascade-discipline.md |
saga-25 — propagating a fix-pattern across N callers via repeated ptc invocations |
detector-substrate.md |
saga-26 — 4-piece detector apparatus (lib/detector + registry + CLI + scar-doctrine-pair); actionable = suspects ∩ orphan-scars |
projection-as-substrate-of-truth.md |
saga-26 meta-pattern — chain Projection<S, P> from event-log to actionable signal; ONE substrate-of-truth + N thin-consumers |
Surface signal from substrate.
| file | what |
|---|---|
handcrawl-saga.md |
primary-source handwalk + 3-axis verification matrix (cures script-as-floor survivorship-bias) |
corpus-mining-trio.md |
saga-26 — 3 tools, 3 substrates: cdmgr (code-shape) / import-graph (callers) / seshae-arq (sessions); question-shape determines tool |
| file | what |
|---|---|
saga-24-megaFail-recovery.md |
parallel-invented-shim recovery pattern |
saga-25-codemogger-drift-audit.md |
drift-audit recipe for indexed-corpus tools |
egeo-saga.md |
saga-DSL as cross-harness dispatch primitive (bunqueue/workflow retargeted onto multi-agent pool) |
| file | what |
|---|---|
saga-25-onramp.md |
saga-25 captain cold-start substrate |
saga-26-onramp.md |
saga-26 captain cold-start substrate |
saga-27-onramp.md |
saga-27 captain cold-start substrate (saga-26 → saga-27 handoff) |
auto-saga-arc-2026-05-08.md |
auto-generated saga-arc snapshot |
Each gift includes its own project-retargeting callouts — replace project-specific paths / runtimes / event-log conventions as fits yours. The doctrine is portable; the implementation is project-shaped.
github.com/wommy/gifts/tree/main/scripts — saga-26 reference implementations of edit-primitives / orchestration / cold-start / mining / yeet / detection. (glom_MR-internal: live at scripts/.)
Run bun scripts/projections/gift-evidence.ts to project per-gift heading-shipped + session-event witness counts. Output: memory/auto-gift-evidence.md. Each gift documents real ship-events, not abstract patterns.
Saga-21 BOOM 2026-05-06: an agent burned ~150k tokens fighting plan-mode-instruction-block before realizing operator-grant +
Bash(bun:*)settings already made writes tractable. Saga-25 wall: 22+ TYPE-1 self-catches, each with sister cure-doctrine. Saga-26 first-session: 12 TYPE-1 cap-cure-pairs banked + 13 saga-26 gifts externalized + 4 projections shipped + 5-substrate cap-prep --detect cold-start ritual + cross-civilization 665k+ witness substrate.
The pattern: build doctrines that survive compaction by living in multiple substrates, then share the distillations because the same friction is everyone's friction.
This corpus is mirrored at github.com/wommy/gifts (CC0). 14 gifts pushed saga-26 (4 saga-25 + 10 saga-26).
CC0 — public domain. No attribution required. Adopt + dial freely.