You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Eight 'Worked example' blocks across the Doctrine, Testing, and
Debugging sections all anchored to artifacts that no longer exist
in this repo: `docs/postmortems/phase_e_xfail.md` and
`…/angle_210_overlay_reserve.md` (both deleted with `docs/postmortems/`
in Step E), `torchwright/doom/stages/wall.py` (deleted), the Phase E
(3, 2, 20) xfail (test deleted), `_ABOVE_BONUS` and SORTED stage code
(deleted), and `_VIS_C_TOL` in deleted source. Each was a fragment of
a teaching story whose supporting artifacts now live elsewhere — the
pointers in CLAUDE.md sent readers to dead links.
Cuts:
- Doctrine intro: rewrote 'The DOOM renderer project has a recurring
failure mode…' to drop the DOOM anchor; the doctrine now stands as
general compiler-work guidance.
- D1, D2, D4, D5, D6, D7: deleted each rule's 'Worked example' block.
The rule + Why + Tooling triplet stands on its own.
- D3: kept the worked example but rewrote it to drop the Phase E
anchor; the *and-of-maybes* shape teaches the rule on its own.
('Likely X near Y under Z' replaces the Phase E xfail reason.)
- Testing § 'When full-suite tests fail but `-k` passes': dropped the
trailing 'Worked example: docs/postmortems/angle_210_…' line and
scrubbed `tests/doom/` to 'the full suite'.
- Debugging § 'FP nondeterminism at tolerance boundaries': dropped the
trailing 'Worked example: _VIS_C_TOL = 0.01 in torchwright/doom/…
See docs/postmortems/angle_210_…' block.
The teaching power lost is real but contained — the deleted postmortems
and incident threads remain reachable via git history. What's gained:
no broken pointers in the most-cited section of CLAUDE.md.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
0 commit comments