Skip to content

Commit 38e74db

Browse files
committed
docs(board): CORRECTION-OF sprint-4 framing — most worker specs duplicated existing .claude/plans/ corpus
User surfaced 5 prior plans 2026-05-13 evening: anatomy-realtime-v1.md (19 KB) — IS W11's FMA spec, pre-existing unified-ogit-architecture-v1.md (30 KB, 15 patterns A-O) — supersedes W1 ogit-g-context-bundle-v1.md — already exists (sprint-3 cited) super-domain-rbac-tenancy-v1.md (86 KB, 1387 lines) — canonical PR #363 spec compile-time-consumer-binding-v1.md (23 KB) — Pattern E + F sprint-2 plan Plus prior find: jc-pillars-runtime-wiring-v1.md, lance-graph-rdf-fma-snomed-v1.md, 2026-05-06-splat-osint-ingestion-v1.md, tetrahedral-epiphany-splat-integration-v1.md, foundry-roadmap-unified-smb-medcare-v1.md Duplication audit: W1 / W4 / W6 / W11 specs partially restate prior plans; W3 / W7 / W8 / W9 / W10 / W12 added real value. The workers did not grep .claude/plans/ before drafting. Same root-cause pattern surfaced THREE times in one session: math layer — one kernel Σ' = J·Σ·Jᵀ, three Jacobians substrate — ndarray::hpc::renderer already exists at 60fps plan layer — 30+ plans already cover the architectural surface Fix: sprint-5 worker prompt template MUST include a mandatory read-order section pointing at .claude/plans/ as hard precondition to spec writing. 12-step read-order added to the EPIPHANIES entry covering the most-relevant plans by domain. Sprint-5 priority stack revised: Tier 1 surgical fixes (W10/W8/W9) stand but reframed as DELTA against super-domain-rbac-tenancy §13; Tier 2 W4/W6 specs should be REPLACED with delta-against-prior-plan patches; Tier 3 W11 spec replaced with citation+patches to anatomy-realtime-v1 + lance-graph-rdf-fma-snomed-v1.
1 parent 3fc7e3b commit 38e74db

1 file changed

Lines changed: 64 additions & 0 deletions

File tree

.claude/board/EPIPHANIES.md

Lines changed: 64 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -65,6 +65,70 @@ stay as historical references.
6565

6666
## Entries (reverse chronological)
6767

68+
## 2026-05-13 — CORRECTION-OF sprint-4 framing: most worker specs partially duplicated existing `.claude/plans/` corpus — sprint-5 MUST grep `.claude/plans/*.md` before spawning any worker
69+
70+
**Status:** FINDING (user surfaced prior plans 2026-05-13 evening)
71+
72+
Sprint-4 spawned 12 workers to convert 11 TD rows into PR-ready specs. **Discovered post-hoc that most architectural specs duplicated existing plan-tier docs already on the branch.** The workers did not grep `.claude/plans/` before drafting.
73+
74+
**Duplication audit:**
75+
76+
| Sprint-4 worker spec | Prior plan that already covered it | Duplication |
77+
|---|---|---|
78+
| W1 `sprint-4-execution-plan.md` (24 KB) | `unified-ogit-architecture-v1.md` (30 KB, 15 patterns A-O, master) | High |
79+
| W4 `td-super-domain-subcrates.md` (21 KB) | `super-domain-rbac-tenancy-v1.md` (86 KB / 1387 lines, canonical PR #363 spec) + `foundry-roadmap-unified-smb-medcare-v1.md` | High |
80+
| W11 `fma-heart-click-smoke.md` (28 KB) | `anatomy-realtime-v1.md` (19 KB, the proof-of-vision plan) + `lance-graph-rdf-fma-snomed-v1.md` | High |
81+
| W6 `td-thinking-engine-wire.md` (21 KB) | `jc-pillars-runtime-wiring-v1.md` + ERRATUM | Medium (composition map added value) |
82+
| (today's splat thrash) | `tetrahedral-epiphany-splat-integration-v1.md` + `2026-05-06-splat-osint-ingestion-v1.md` (ACTIVE) + `jc-pillars-runtime-wiring-v1.md` | High |
83+
84+
**What sprint-4 DID add (the real value):**
85+
- W3 API drift deprecation playbook — no prior plan covered this
86+
- W7 D-SDR PR release plan — captures concrete next-PR (PR-A on top of #363) with SHAs
87+
- W8 audit Lance/JSONL sink spec — prior plans mention LanceAuditSink as substrate but no implementation spec
88+
- W10 slot u8→u16 widen + bridge-err audit — surgical fixes; no prior plan
89+
- W12 cross-repo PR graph — sprint sequencing artifact
90+
- W9 family hydration — surgical fix; no prior plan
91+
92+
**The lesson at THREE layers today:**
93+
1. **Math layer:** one kernel `Σ' = J·Σ·Jᵀ`, three Jacobians (camera projection / edge step / radial decay) — not three separate "splat" concepts
94+
2. **Substrate layer:** `ndarray::hpc::renderer` already exists with 60fps double-buffer + EWA-splat projection; no new render crate needed
95+
3. **Plan layer:** `.claude/plans/*.md` has 30+ plans already covering the architectural surface; worker subagents must grep before drafting
96+
97+
**Sprint-5 mandatory read-order fix:**
98+
99+
Before spawning ANY worker on a spec touching FMA / OGIT / super-domain / RBAC / splat / EWA / Pillar-N / cognitive shader / consumer crate / audit / thinking-engine:
100+
101+
```
102+
1. ls .claude/plans/ | head -40 # see all 30+ plan files
103+
2. cat .claude/plans/unified-ogit-architecture-v1.md # the 15-pattern master plan (A-O)
104+
3. cat .claude/plans/anatomy-realtime-v1.md # the FMA proof-of-vision plan
105+
4. cat .claude/plans/super-domain-rbac-tenancy-v1.md # the canonical RBAC/tenancy spec (1387 lines)
106+
5. cat .claude/plans/jc-pillars-runtime-wiring-v1.md # the JC pillar stack (pillars 5/5+/5++/6/7)
107+
6. cat .claude/plans/foundry-roadmap-unified-smb-medcare-v1.md # consumer crate roadmap
108+
7. cat .claude/plans/compile-time-consumer-binding-v1.md # Pattern E (manifest modules) + F (ractor supervisor)
109+
8. cat .claude/plans/ogit-g-context-bundle-v1.md # Tier-1 SPO-G slot + ContextBundle + GenericBridge
110+
9. cat .claude/plans/2026-05-06-splat-osint-ingestion-v1.md # ACTIVE splat-OSINT plan
111+
10. cat .claude/plans/tetrahedral-epiphany-splat-integration-v1.md # SPOW tetrahedral grid + splat integration
112+
11. cat .claude/plans/lance-graph-rdf-fma-snomed-v1.md # FMA + SNOMED + RadLex named-graph ingest
113+
12. grep -l "<topic>" .claude/plans/ # find any topic-specific plans
114+
```
115+
116+
Worker prompts must include: "Before drafting, read these specific plan files: [...]. Cite them or explain why your spec adds value beyond them."
117+
118+
**Sprint-5 priority stack — REVISED against the real plan corpus:**
119+
120+
The Tier 0-4 stack from earlier today still holds for TD coverage, BUT the deliverable framing changes:
121+
122+
- **Tier 0** (PR follow-up, ~1 day) — UNCHANGED. PR-A composes the existing 3 commits on top of PR #363; SHAs already captured in W7's spec.
123+
- **Tier 1** (substrate, ~1 week) — W10 + W8 + W9 are still the right surgical fixes. **But** they need to be reframed as DELTA against `super-domain-rbac-tenancy-v1.md §13` (D-SDR-3..5 already named there). Each PR should cite §X of that plan.
124+
- **Tier 2** (composable wiring, ~2 weeks) — W4 and W6 should NOT use the sprint-4 specs as-is. Both must be rewritten as DELTA against existing plans:
125+
- W4: against `super-domain-rbac-tenancy-v1.md §14` (meta-bridge extraction, woa retrofit, hubspot/hiro templates already named) + `foundry-roadmap-unified-smb-medcare-v1.md` (LF-3 critical path)
126+
- W6: against `jc-pillars-runtime-wiring-v1.md` (the pillar wiring already plans the thinking-engine composition)
127+
- **Tier 3** (FMA convergence) — W11's spec should be REPLACED with citations to `anatomy-realtime-v1.md` (already the proof-of-vision plan) + `lance-graph-rdf-fma-snomed-v1.md` (already the FMA ingest plan). Sprint-4 W11 spec keeps its drug-knowledge crosswalk + two-tier-ingest patches as additions to those plans.
128+
- **Tier 4** (perf) — W5 unchanged; no prior plan duplication.
129+
130+
**The honest meta-pattern:** I generated three classes of correction today (math/substrate/plan) for the same root cause — conjecturing before grepping. The fix is not "be more careful next time" — it's "the worker prompt template MUST include a mandatory read-order section pointing at `.claude/plans/`, and that section must be a hard precondition to spec writing." Update worker prompt templates for sprint-5.
131+
68132
## 2026-05-13 — UNIFICATION: Gaussian-splat + EWA-Sandwich is ONE kernel (`Σ' = J·Σ·Jᵀ`) applied to THREE Jacobians across the workspace — render, graph propagation, perturbation field
69133

70134
**Status:** FINDING (corrects the same-day three-meanings-of-splat entry that wrongly split them apart; user-corrected 2026-05-13)

0 commit comments

Comments
 (0)