docs(phase-33.5): task 1 — unblock, code side: seven tool docstring/comment cites re-pointed off docs/tool-designs and docs/hindsight-study (decision-log S61 entry, cookbook §260, how-to ch.03 Phase 2b); CLAUDE.md R1–R83, the H1 fail-safe dated to Phase 33 C3, the effort default = the DIGEST §1 doctrine; log + checkpoint

tools/autopsy.py

@@ -1,7 +1,8 @@
 #!/usr/bin/env python3
 """autopsy.py — the permuter-failure autopsy: mine the search-closer's FAILURES (Phase-29 Task-13).
 
-docs/hindsight-study.md §7. Our flywheel (R16) has always evolved the offline tooling REACTIVELY
+The permuter track of docs/how-to-ai-decomp/03-bootstrap-order.md (Phase 2b; originally §7 of the July-2026
+hindsight study, since archived). Our flywheel (R16) has always evolved the offline tooling REACTIVELY
 FROM SUCCESSES: a human or an LLM cracks a function, we distil the idiom into the cookbook and the
 permuter weights. The permuter's FAILURES — every near-miss it plateaued on — are a larger and
 completely unused signal. This tool turns that log into a corpus, classifies it deterministically,

tools/decl_from_use.py

@@ -1,7 +1,8 @@
 #!/usr/bin/env python3
 """decl_from_use.py — infer a draft's MISSING data extern from the target .s + the draft's own use.
 
-WHY THIS EXISTS (P31 S61; docs/tool-designs/frontier-analysis-s60.md §5 step 4). Two refusal sites
+WHY THIS EXISTS (P31 S61; the S60 frontier analysis — recorded in docs/decision-log.md, the 2026-08-25
+"the wall is an integration wall" entry). Two refusal sites
 throw away drafts whose only defect is a data symbol the destination TU never declares:
   * aprop_autodraft.py (~:522) refuses `no seed decl for D_x` — the member body is correct, but no
     seed/destination/fleet TU spells the extern, so the A-prop lane never emits the draft;

tools/integration_resolver.py

@@ -1,7 +1,8 @@
 #!/usr/bin/env python3
 """integration_resolver.py — the zero-token lane over drafts that are ALREADY CORRECT (P31 S61).
 
-WHY THIS EXISTS. The S60 frontier analysis (docs/tool-designs/frontier-analysis-s60.md §4) measured
+WHY THIS EXISTS. The S60 frontier analysis (recorded in docs/decision-log.md, the 2026-08-25 "the wall is
+an integration wall" entry) measured
 that the gen6+ "wall" is an INTEGRATION wall, not a codegen wall: of the 292 functions the gate had
 refused six or more times, 178 (61%) had already produced a closeness-0 draft — match_one byte-
 equality at the object level, whole-binary gate rejection — and across the whole open pool ~571

tools/jtbl_carve.py

@@ -743,7 +743,7 @@ def island_split(ov, func):
     Writes ONLY config/splat.<ov>.yaml (one inserted line). No overlays.mk var (a single-table
     piece needs none — §8e), no extract (the caller extracts). The island piece at 0x0 is left
     untouched: its extent shrinks automatically (end = next piece's offset) — the review-proven
-    correction to the `_pre` design (docs/tool-designs/jtbl-island-split-review.md #7)."""
+    correction to the `_pre` design (cookbook §260, the review's correction #7)."""
     kind, detail = island_probe(ov, func)
     if kind == "covered":
         print(f"jtbl_carve --island-split {ov} {func}: already split — no-op ({detail})")
@@ -891,7 +891,7 @@ def build_carve(ov, funcs):
             # rewrites [tail_start, region_end), so the piece line would land out of address order
             # and splat would mis-slice the module. That is the island-split lane's job — ONE
             # inserted `.rodata` line at the table's own offset plus jr_isolate_all.py --only
-            # (docs/tool-designs/jtbl-island-split-review.md) — so name it and refuse (R43).
+            # (cookbook §260) — so name it and refuse (R43).
             isl_off = int(jh, 16) - base
             if isl_off < tail_start:
                 sys.exit(
@@ -900,7 +900,7 @@ def build_carve(ov, funcs):
                     f"island, which a tail carve cannot reach. That is the island split (§260): "
                     f"jr_isolate_all.py --only {f}, then `jtbl_carve.py {ov} --island-split "
                     f"--func {f}` — automated at gate time by harvest_verify._jtbl_prep_one "
-                    f"(docs/tool-designs/jtbl-island-split-review.md). "
+                    f"(cookbook §260). "
                     f"FOR AN md_* MODULE, §303 SUPERSEDES THIS: no isolation, no carve state — splice and "
                     f"`make build`; the Makefile's jtbl_rodata_pads --derive stage reproduces the island pads at "
                     f"build time (P32 S83: md_SC03_054/func_801EF6D8, 7 tables, 0,0t1,0t1,0t1,0t1,0t1,0).")

tools/residual_class.py

@@ -1,7 +1,8 @@
 #!/usr/bin/env python3
 """residual_class.py — the DETERMINISTIC residual→class classifier (Phase-29 Task-13A).
 
-The permuter-failure autopsy (docs/hindsight-study.md §7) needs to route every plateau to one of
+The permuter-failure autopsy (the permuter track of docs/how-to-ai-decomp/03-bootstrap-order.md, Phase 2b;
+originally §7 of the July-2026 hindsight study, since archived) needs to route every plateau to one of
   missing-transform | mis-classified | seed-structural | genuine-wall
 and today that routing is done by an LLM reading a scalar (`closeness`) plus a free-text
 `where_stuck` label a wave agent typed months ago. Both are weak: 91% of the open backlog has NO