Skip to content

Commit a179a87

Browse files
committed
plans: sprint-5-through-9 roadmap with 12-worker + 2-meta rosters per sprint, file scope per agent
5 sprints × (12 workers + 2 meta) = 70 agents total. Every W{N} owns exactly ONE distinct .claude/specs/ file path. Meta agents own distinct .claude/board/sprint-log-{N}/meta-*-review.md paths. Sprint 5 (1 wk, substrate close-out): PR-A D-SDR-3/4/5 follow-up + 5 surgical fix PRs (slot widen, bridge-err audit, audit sinks Lance+JSONL, family hydration, compat shim) Sprint 6 (2 wk, Tier-2 wiring): 5 super-domain subcrate cascade PRs (medcare/smb/woa/hiro/hubspot) + thinking-engine wire + manifest modules + ractor supervisor — ALL extending prior plans, not redrafting Sprint 7 (1 wk, FMA convergence): lance-graph-rdf border crate + FMA two-tier ingest + q2 Cypher wire + heart-click integration test + Pillar 6 EWA propagation + SIMD callcenter retrofit + SNOMED+RadLex companions + drug-knowledge crosswalk Sprint 8 (2 wk, compliance): TTL namespaces + HIPAA/SOX/GDPR cert surfaces + OSINT LanceProbe + Federation Phase 2 + audit replay CLI + BAA export + encryption-at-rest gate — addresses D-SDR-6..D-SDR-39 deferred by PR #363 Sprint 9 (1-2 wk, sales asset, parallelizable): holographic q2 UX (splat shader + highlight column + canonical pose + layer toggle) + prerender cinematic pipeline (offline tool + player + release artifact) + camera storyboard + palette curation + audio cues + recording script Critical-path total (5+6+7): 4 weeks, ~7100 LOC. Sprints 8/9 independently scheduleable. Pattern documented end-to-end: - pre-write SPRINT_LOG.md with roster + mandatory reads - 12 sonnet workers parallel-spawn in single main-thread call - meta agents (opus) after workers complete - main thread aggregates commits + pushes - governance updates per board-hygiene rule Worker-prompt template fix from sprint-4 retro baked in: every prompt includes 12-step .claude/plans/ mandatory-read list as hard precondition.
1 parent d702818 commit a179a87

1 file changed

Lines changed: 222 additions & 0 deletions

File tree

Lines changed: 222 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,222 @@
1+
# Sprint 5–9 Roadmap — D-SDR Follow-up to FMA Convergence to Compliance Certification
2+
3+
> **Status:** v1 plan, 2026-05-13 evening
4+
> **Branch:** `claude/lance-datafusion-integration-gv0BF`
5+
> **Predecessor:** PR #363 merged at `421e71e` (D-SDR-1 + D-SDR-2 + canonical spec)
6+
> **Current branch state:** 16 commits ahead of `main` — D-SDR-3/4/5 + sprint-log-4 governance/specs
7+
> **Sprint-4 retrospective:** see `.claude/board/EPIPHANIES.md` 2026-05-13 duplication-audit entry; sprint-4 specs partially duplicated prior plan corpus. Sprint-5+ worker prompts must include mandatory `.claude/plans/` read-order as hard precondition.
8+
9+
---
10+
11+
## Worker-prompt template fix (applies to ALL sprints)
12+
13+
Before spawning any worker on an architectural spec, the prompt MUST include:
14+
15+
```
16+
Mandatory read-order BEFORE drafting:
17+
1. ls .claude/plans/ | head -40
18+
2. Read all plans matching: grep -l "<your topic>" .claude/plans/
19+
3. Read these by default:
20+
- .claude/plans/unified-ogit-architecture-v1.md (15-pattern master)
21+
- .claude/plans/super-domain-rbac-tenancy-v1.md (canonical RBAC/tenancy)
22+
- .claude/plans/anatomy-realtime-v1.md (proof-of-vision FMA demo)
23+
4. Your spec must be a DELTA against the relevant plan, not a fresh draft.
24+
Cite §X of the plan you're extending, or explain why you're not.
25+
```
26+
27+
This single change is the highest-leverage fix from sprint-4 retrospective.
28+
29+
---
30+
31+
## Sprint 5 — Substrate close-out (1 week)
32+
33+
**Goal:** ship PR-A (D-SDR-3/4/5 follow-up) + the 3 surgical fixes that unblock everything downstream.
34+
35+
**Worker roster (12 + 2 meta) — each owns ONE file:**
36+
37+
| Agent | File scope | Deliverable |
38+
|---|---|---|
39+
| W1 | `.claude/specs/sprint-5-execution-plan.md` | Sprint-5 master plan + PR-A body draft + sprint-4 retrospective summary |
40+
| W2 | `.claude/specs/s5-pr-a-d-sdr-followup.md` | PR-A body (cite `super-domain-rbac-tenancy-v1.md §13`; SHAs `2c3e87d`/`1d0157f`/`dabd510`/`dc9e081`) |
41+
| W3 | `.claude/specs/s5-pr-b-medcare-consumer-push.md` | medcare-rs UnifiedBridge wiring PR body + pre-push verify commands |
42+
| W4 | `.claude/specs/s5-pr-c-smb-office-consumer-push.md` | smb-office-rs UnifiedBridge wiring PR body + pre-push verify commands |
43+
| W5 | `.claude/specs/s5-pr-d1-slot-u16-widen.md` | Slot u8→u16 widen + `slot_u8()` deprecated shim + 65k-id round-trip test |
44+
| W6 | `.claude/specs/s5-pr-d2-bridge-err-audit.md` | `authorize_*` refactor `?``match`; invert test at line 690; probe-detection dashboard SQL |
45+
| W7 | `.claude/specs/s5-pr-d3a-lance-audit-sink.md` | LanceAuditSink with Arrow schema (u64 FNV-1a merkle) + Hive partitioning |
46+
| W8 | `.claude/specs/s5-pr-d3b-jsonl-audit-sink.md` | JsonlAuditSink + CompositeSink + `audit-verify` CLI for chain replay |
47+
| W9 | `.claude/specs/s5-pr-d4-family-hydration.md` | `new_hydrated()` + `SuperDomain::Unhydrated=255` + 1-hour TTL refresh + sanity gate |
48+
| W10 | `.claude/specs/s5-pr-d5-compat-shim.md` | `compat_v0_4` shim layer for D-SDR API drift + 30-day auto-deletion CI lint |
49+
| W11 | `.claude/specs/s5-ci-matrix.md` | Per-PR green-gates; cross-repo zipball build matrix; rollback SLA |
50+
| W12 | `.claude/specs/s5-handover-to-s6.md` | Sprint-5 retrospective + sprint-6 setup checklist + mandatory-reads inventory |
51+
| M1 | `.claude/board/sprint-log-5/meta-1-review.md` | Per-worker brutal review |
52+
| M2 | `.claude/board/sprint-log-5/meta-2-review.md` | Cross-spec synthesis + governance updates |
53+
54+
**Each worker scratchpad:** `.claude/board/sprint-log-5/agents/agent-W{N}.md` via `tee -a` append-only.
55+
56+
**Critical mandatory-reads in every W{N} prompt:** the 12-step list from `EPIPHANIES.md` 2026-05-13 duplication-audit entry.
57+
58+
**Gates:** PR-A (W2) must merge before PR-B (W3) / PR-C (W4); PR-D1 (W5) before PR-D3a (W7).
59+
60+
---
61+
62+
## Sprint 6 — Tier-2 composable wiring (2 weeks)
63+
64+
**Goal:** wire thinking-engine into UnifiedBridge + cascade super-domain subcrates. All workers MUST extend prior plans, not redraft.
65+
66+
**Worker roster (12 + 2 meta):**
67+
68+
| Agent | File scope | Deliverable | Prior plan to extend |
69+
|---|---|---|---|
70+
| W1 | `.claude/specs/sprint-6-execution-plan.md` | Master plan + dependency graph | All below |
71+
| W2 | `.claude/specs/s6-pr-e1-medcare-specialisation.md` | MedCare super-domain finalisation | `super-domain-rbac-tenancy-v1.md §14` + `foundry-roadmap §LF-3` |
72+
| W3 | `.claude/specs/s6-pr-e2-smb-retrofit.md` | smb-office-rs retrofit to UnifiedBridge generic | `super-domain-rbac-tenancy-v1.md §14` |
73+
| W4 | `.claude/specs/s6-pr-e3-woa-extraction.md` | woa-rs extraction from q2/geo | `super-domain-rbac-tenancy-v1.md §14` |
74+
| W5 | `.claude/specs/s6-pr-e4-hiro-scaffold.md` | hiro-rs new repo (Networking/SRE template) | `super-domain-rbac-tenancy-v1.md §14` |
75+
| W6 | `.claude/specs/s6-pr-e5-hubspot-scaffold.md` | hubspot-rs new repo (CRM template) | `super-domain-rbac-tenancy-v1.md §14` |
76+
| W7 | `.claude/specs/s6-pr-f1-thinking-engine-wire.md` | `lance-graph-cognition-bridge` crate; collapse D-SDR-13/15/17 | `jc-pillars-runtime-wiring-v1.md` + `compile-time-consumer-binding-v1.md §F` |
77+
| W8 | `.claude/specs/s6-pr-g1-manifest-modules.md` | `/modules/<name>/manifest.yaml` build-script + codegen | `compile-time-consumer-binding-v1.md §E` |
78+
| W9 | `.claude/specs/s6-pr-g2-ractor-supervisor.md` | `CallcenterSupervisor` ractor port | `compile-time-consumer-binding-v1.md §F` |
79+
| W10 | `.claude/specs/s6-conformance-tests.md` | Workspace-wide `consumer-crates-conformance` CI gate | `super-domain-rbac-tenancy-v1.md §14` |
80+
| W11 | `.claude/specs/s6-cross-repo-pr-graph.md` | PR sequencing across 5 super-domain repos | `foundry-roadmap §LF-3..LF-8` |
81+
| W12 | `.claude/specs/s6-handover-to-s7.md` | Sprint-6 retro + sprint-7 setup | (output of all above) |
82+
| M1 | `.claude/board/sprint-log-6/meta-1-review.md` | Per-worker review |
83+
| M2 | `.claude/board/sprint-log-6/meta-2-review.md` | Cross-spec synthesis |
84+
85+
**Gates:** W2..W6 land sequentially per foundry-roadmap order. W7 + W8/W9 parallel-track.
86+
87+
---
88+
89+
## Sprint 7 — FMA convergence + Tier-4 perf (1 week)
90+
91+
**Goal:** ship the FMA proof-of-vision demo per `anatomy-realtime-v1.md`. SIMD callcenter retrofit in parallel.
92+
93+
**Worker roster (12 + 2 meta):**
94+
95+
| Agent | File scope | Deliverable | Prior plan to extend |
96+
|---|---|---|---|
97+
| W1 | `.claude/specs/sprint-7-execution-plan.md` | Master plan | `anatomy-realtime-v1.md` |
98+
| W2 | `.claude/specs/s7-pr-h1-lance-graph-rdf-crate.md` | New border crate: RDF ingest + OntologyContextId + SemanticQuad | `lance-graph-rdf-fma-snomed-v1.md` |
99+
| W3 | `.claude/specs/s7-pr-h2-fma-owl-ingest.md` | FMA OWL Tier-2 ingest (full graph, BioPortal source) | `lance-graph-rdf-fma-snomed-v1.md` |
100+
| W4 | `.claude/specs/s7-pr-h2b-fma-csv-quick.md` | FMA CSV Tier-1 ingest (preview/bootstrap) | (new — sprint-4 W11 patch) |
101+
| W5 | `.claude/specs/s7-pr-h3-q2-cypher-wire.md` | q2 graph-notebook Cypher cell → UnifiedBridge auth chain | `anatomy-realtime-v1.md` |
102+
| W6 | `.claude/specs/s7-pr-h4-heart-click-test.md` | Heart-click integration test (5 golden inputs) + Pillar 6 EWA propagation assertion | `anatomy-realtime-v1.md` + `jc-pillars §6` |
103+
| W7 | `.claude/specs/s7-pr-h5-simd-callcenter.md` | `vsa_udfs.rs` scalar→`ndarray::hpc::{vsa,bitwise}` retrofit | (sprint-4 W5 spec, corrected) |
104+
| W8 | `.claude/specs/s7-pr-h6-drug-knowledge-crosswalk.md` | MedCare drug-knowledge-2026-05-05 pivot integration | (MedCare-rs release) |
105+
| W9 | `.claude/specs/s7-pr-h7-snomed-ingest.md` | SNOMED-CT ingest (companion to FMA, license-gated) | `lance-graph-rdf-fma-snomed-v1.md` |
106+
| W10 | `.claude/specs/s7-pr-h8-radlex-ingest.md` | RadLex radiology imaging labels ingest | `lance-graph-rdf-fma-snomed-v1.md` |
107+
| W11 | `.claude/specs/s7-cross-crate-dep-graph.md` | sprint-7 dependency graph + parallel-track ordering | (output of W2..W10) |
108+
| W12 | `.claude/specs/s7-handover-to-s8.md` | Sprint-7 retro + sprint-8 setup + FMA demo recording protocol ||
109+
| M1 | `.claude/board/sprint-log-7/meta-1-review.md` | Per-worker review |
110+
| M2 | `.claude/board/sprint-log-7/meta-2-review.md` | Cross-spec synthesis |
111+
112+
**Gates:** W2 → W3 → W5 → W6 sequential. W4 + W7 + W8 + W9 + W10 parallel.
113+
114+
---
115+
116+
## Sprint 8 — TTL namespaces + compliance certification (2 weeks)
117+
118+
**Goal:** address D-SDR-6..D-SDR-39 scope deferred by PR #363. Hardens product for customer compliance audits.
119+
120+
**Worker roster (12 + 2 meta):**
121+
122+
| Agent | File scope | Deliverable |
123+
|---|---|---|
124+
| W1 | `.claude/specs/sprint-8-execution-plan.md` | Master plan + compliance test matrix |
125+
| W2 | `.claude/specs/s8-pr-i1-ttl-namespaces.md` | TTL namespace registry + per-tenant entity-type ranges |
126+
| W3 | `.claude/specs/s8-pr-i2-hipaa-cert.md` | HIPAA cert surface: BAA audit export + encryption-at-rest gate |
127+
| W4 | `.claude/specs/s8-pr-i3-sox-cert.md` | SOX: financial-data segregation + dual-control audit emissions |
128+
| W5 | `.claude/specs/s8-pr-i4-gdpr-cert.md` | GDPR: right-to-erasure tombstones + data-minimization predicate rewrites |
129+
| W6 | `.claude/specs/s8-pr-i5-osint-lanceprobe.md` | `osint_edge_traversal.rs` → production; LanceProbe M5/M6 unblock |
130+
| W7 | `.claude/specs/s8-pr-i6-federation-phase2.md` | LanceDB transparent encrypted view for cross-tenant queries |
131+
| W8 | `.claude/specs/s8-audit-replay-cli.md` | Deep-dive: `audit-verify` CLI v2 with selective tenant/date-range replay |
132+
| W9 | `.claude/specs/s8-baa-audit-export-schema.md` | BAA-ready audit export format (CSV/JSON/PARQUET) + chain-of-custody proof |
133+
| W10 | `.claude/specs/s8-encryption-at-rest-gate.md` | Encryption-at-rest enforcement at Lance write boundary + KMS integration sketch |
134+
| W11 | `.claude/specs/s8-compliance-test-matrix.md` | Per-regime test matrix + customer-audit-readiness checklist |
135+
| W12 | `.claude/specs/s8-handover-to-s9.md` | Sprint-8 retro + sprint-9 setup |
136+
| M1 | `.claude/board/sprint-log-8/meta-1-review.md` | Per-worker review |
137+
| M2 | `.claude/board/sprint-log-8/meta-2-review.md` | Cross-spec synthesis |
138+
139+
**Gates:** W2 (TTL) first. W3..W6 parallel. W7 last (depends on encryption surface from W10).
140+
141+
---
142+
143+
## Sprint 9 — Q2 cockpit + holographic cinematic (1-2 weeks, parallelizable)
144+
145+
**Goal:** ship the holographic UX + WOW cinematic. Sales-asset budget; can run parallel to sprints 5-8.
146+
147+
**Worker roster (12 + 2 meta):**
148+
149+
| Agent | File scope | Deliverable |
150+
|---|---|---|
151+
| W1 | `.claude/specs/sprint-9-execution-plan.md` | Master plan + storyboard outline |
152+
| W2 | `.claude/specs/s9-pr-j1-q2-splat-shader.md` | q2 frontend Gaussian-splat WGSL/GLSL fragment shader (additive blending + bloom + cyan palette) |
153+
| W3 | `.claude/specs/s9-pr-j2-render-frame-highlight.md` | `RenderFrame::highlight` SoA column + Pillar 6 Σ-displacement write-back |
154+
| W4 | `.claude/specs/s9-pr-j3-fma-canonical-pose.md` | T-pose canonical-pose seeder; procedural RenderFrame initial state |
155+
| W5 | `.claude/specs/s9-pr-j4-layer-toggle.md` | Per-system layer toggle UI + `SuperDomain::Healthcare` family slice filter |
156+
| W6 | `.claude/specs/s9-pr-j5-cinematic-prerender-tool.md` | `crates/fma-cinematic` offline tool: trajectory + Floyd-Steinberg dither + Lance schema |
157+
| W7 | `.claude/specs/s9-pr-j6-cinematic-player.md` | q2 cinematic player: Lance read + AVX2 nibble unpack + canvas blit |
158+
| W8 | `.claude/specs/s9-pr-j7-release-artifact.md` | `intro-v1.lance` release artifact + q2 session-start hook |
159+
| W9 | `.claude/specs/s9-camera-trajectory-storyboard.md` | Hand-curated 30-90 s camera path: full-body → cardiovascular → heart |
160+
| W10 | `.claude/specs/s9-cyan-palette-curation.md` | 16-color cyan/teal/white palette design + accessibility check |
161+
| W11 | `.claude/specs/s9-audio-cue-design.md` | Web Audio API integration: hover/click cues + ambient drone for hologram |
162+
| W12 | `.claude/specs/s9-demo-recording-script.md` | Demo recording script + sales-pitch sync points |
163+
| M1 | `.claude/board/sprint-log-9/meta-1-review.md` | Per-worker review |
164+
| M2 | `.claude/board/sprint-log-9/meta-2-review.md` | Cross-spec synthesis |
165+
166+
**Gates:** W2..W5 (live UX) before live recording starts. W6..W8 + W9..W11 parallel; W12 last.
167+
168+
**Owner:** demo / marketing budget, NOT engineering critical path.
169+
170+
---
171+
172+
## Agent dispatch pattern (applies to every sprint)
173+
174+
Per `sprint-log-2/3/4` precedent (see `.claude/board/sprint-log-*/SPRINT_LOG.md`):
175+
176+
1. **Pre-write** `.claude/board/sprint-log-{N}/SPRINT_LOG.md` with worker roster + mandatory-reads inventory
177+
2. **Spawn 12 worker agents in parallel** (single main-thread Agent tool call with 12 invocations). All sonnet (medium context). Each prompt:
178+
- States the worker ID + file scope + deliverable
179+
- Embeds the 12-step `.claude/plans/` mandatory-read list
180+
- Instructs `tee -a .claude/board/sprint-log-{N}/agents/agent-W{X}.md` for milestones
181+
- Reminds: "Write tool IS pre-allowed for *.md; retry once if denied"
182+
- Reminds: "DO NOT git commit/push — main thread aggregates"
183+
3. **Wait for completion notifications** (background async)
184+
4. **Spawn meta agents** (M1 + M2, opus model) after all workers complete. M1 reads all worker logs + specs; M2 cross-synthesizes.
185+
5. **Main thread commits + pushes** all artifacts in one batch (workers' specs, scratchpads, meta reviews, SPRINT_LOG.md).
186+
6. **Update governance** per board-hygiene rule: LATEST_STATE.md / PR_ARC_INVENTORY.md / STATUS_BOARD.md / AGENT_LOG.md.
187+
188+
**Permission gotcha (from sprint-4 retro):** sonnet workers occasionally bail at first Write denial. Prompt template includes explicit "RETRY ONCE if denied" instruction. `Bash(tee:*)` is bulletproof fallback; `Write(**/*.md)` is preferred when it works.
189+
190+
---
191+
192+
## Cumulative sizing
193+
194+
| Sprint | Calendar | Est. total LOC | Critical-path-blocking? |
195+
|---|---|---|---|
196+
| Sprint 5 | 1 week | ~1350 + 0 (existing commits) | Yes — blocks all downstream |
197+
| Sprint 6 | 2 weeks | ~3300 | Yes — Tier-2 wiring |
198+
| Sprint 7 | 1 week | ~2450 | Yes — FMA proof-of-vision |
199+
| Sprint 8 | 2 weeks | ~3600 | Customer compliance (per sales pressure) |
200+
| Sprint 9 | 1-2 weeks | ~1700 | Sales asset, parallelizable |
201+
202+
**Critical-path total (sprints 5+6+7):** 4 weeks, ~7100 LOC. Sprint 8 + 9 are independently scheduleable.
203+
204+
---
205+
206+
## Open questions for human reviewer
207+
208+
1. **Sprint 6 PR-E3..E5 (woa-rs / hiro-rs / hubspot-rs new repos):** confirm these get separate `adaworldapi/<name>-rs` repos vs subcrates of an existing one. Affects CI matrix.
209+
2. **Sprint 8 priority:** does customer pipeline contain a HIPAA-blocking deal that pulls sprint 8 forward of sprint 7? If yes, swap.
210+
3. **Sprint 9 budget approval:** demo team have ~1 week to spend, or held until sales asks?
211+
4. **MedCare-rs drug-knowledge-2026-05-05 release:** is this a sprint-7 PR-H6 must-have or a sprint-8+ enrichment?
212+
5. **Sprint 5 PR-D5 (compat shim):** consumer repos already merged or do they require a coordinated cutover? Affects PR-A acceptance criteria.
213+
214+
---
215+
216+
## Mandatory governance updates per merged PR
217+
218+
Every PR in this roadmap must update (in the same commit, per `CLAUDE.md` board-hygiene rule):
219+
- `.claude/board/LATEST_STATE.md` — contract inventory + shipped table
220+
- `.claude/board/PR_ARC_INVENTORY.md` — PREPEND entry with Added / Locked / Deferred / Docs / Confidence
221+
- `.claude/board/STATUS_BOARD.md` — D-id row status flip
222+
- `.claude/board/AGENT_LOG.md` — if agent-driven, PREPEND completion entry

0 commit comments

Comments
 (0)