at main
10 folders
1 file
feat: codebase-design design lens (reference tactic; resolves charter item 9)
Authors the lens from docs/specs/2026-06-22-design-lens-design.md — a Layer-2
*reference* tactic (affords, never gates; not the floor class, no §13 admission
test). Lens-content only; spine wiring stays the companion spec.
- skills/codebase-design/SKILL.md — brakes-first (§4): no-seam-for-one-impl,
deletion test, interface-is-test-surface; priority #1 kept load-bearing
("deep is never a license to add machinery"); size trigger retired →
event-driven (§5); teaching tax dropped, prose over ASCII.
- §7 seam de-collision dogfooded both ways: the lens names refactor-safety-net's
observe-to-pin use; reciprocal one-liner added to refactor-safety-net/SKILL.md.
- §8 over-design-reflex evidence authored, NOT run (author-only decision):
test/codebase-design-{pressure.md,.rubric,-v2-notes.md}. Inverted RED/GREEN
reading (measures reduction of a reflex, not holding a floor); run command +
interpretation guide in the notes file; results marked PENDING RUN.
- charter deferred item 9 → RESOLVED (standalone design tactic = this lens);
README skill bullet.
Settled §10 opens: name codebase-design (avoids the `design` stage collision);
single lean SKILL.md, DEEPENING/DESIGN-IT-TWICE deferred. No pressure run yet ⇒
no REFACTOR (spec §12). Lens spec status-header edit left uncommitted with the
groundwork-docs changeset.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XnZqt1iHuGZ7b8PpY26hRH
feat: codebase-design design lens (reference tactic; resolves charter item 9)
Authors the lens from docs/specs/2026-06-22-design-lens-design.md — a Layer-2
*reference* tactic (affords, never gates; not the floor class, no §13 admission
test). Lens-content only; spine wiring stays the companion spec.
- skills/codebase-design/SKILL.md — brakes-first (§4): no-seam-for-one-impl,
deletion test, interface-is-test-surface; priority #1 kept load-bearing
("deep is never a license to add machinery"); size trigger retired →
event-driven (§5); teaching tax dropped, prose over ASCII.
- §7 seam de-collision dogfooded both ways: the lens names refactor-safety-net's
observe-to-pin use; reciprocal one-liner added to refactor-safety-net/SKILL.md.
- §8 over-design-reflex evidence authored, NOT run (author-only decision):
test/codebase-design-{pressure.md,.rubric,-v2-notes.md}. Inverted RED/GREEN
reading (measures reduction of a reflex, not holding a floor); run command +
interpretation guide in the notes file; results marked PENDING RUN.
- charter deferred item 9 → RESOLVED (standalone design tactic = this lens);
README skill bullet.
Settled §10 opens: name codebase-design (avoids the `design` stage collision);
single lean SKILL.md, DEEPENING/DESIGN-IT-TWICE deferred. No pressure run yet ⇒
no REFACTOR (spec §12). Lens spec status-header edit left uncommitted with the
groundwork-docs changeset.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XnZqt1iHuGZ7b8PpY26hRH