Files
claw/docs/superpowers/plans/2026-04-19-boundary-family-real-sample-entry-roadmap-plan.md

140 lines
3.7 KiB
Markdown

# Boundary Family Real-Sample Entry Roadmap Plan
> Date: 2026-04-19
> Status: Draft
> Upstream Spec: [2026-04-19-boundary-family-real-sample-entry-roadmap-design.md](D:/data/ideaSpace/rust/sgClaw/claw-new/docs/superpowers/specs/2026-04-19-boundary-family-real-sample-entry-roadmap-design.md)
## Plan Intent
This roadmap determines the next bounded step after `G1-E / G2 / G3` have all closed as executed real-sample passes.
Its only purpose is:
`decide whether one boundary family may enter real-sample execution scope next`
## Scope Guardrails
1. do not reopen `G1-E / G2 / G3`
2. do not implement runtime-platform prerequisites under this roadmap
3. do not execute real samples for more than one boundary family
4. do not open `G4 / G5`
5. do not turn this work into a new family-asset expansion program
## Candidate Boundary Families
The only candidates under this roadmap are:
1. `G6`
2. `G7`
3. `G8`
## Workstreams
1. `WS1` Freeze the Post-Mainline Starting State
2. `WS2` Evaluate Boundary-Family Entry Readiness
3. `WS3` Select One Next Candidate or Hold All
4. `WS4` Publish the Next Bounded Execution Slice
## Phase 0: Freeze the Starting State
### Objective
Lock the roadmap start point so the decision does not drift back into old mainline work.
### Tasks
1. freeze `G1-E / G2 / G3` as closed executed passes
2. freeze `G6 / G7 / G8` as held boundary families
3. freeze `G4 / G5` as out of scope
### Deliverables
1. starting-state note
2. fixed candidate list
### Acceptance Criteria
1. no mainline or deferred family work is reopened under this roadmap
## Phase 1: Evaluate Boundary-Family Entry Readiness
### Objective
Compare `G6 / G7 / G8` against explicit entry criteria instead of intuition.
### Tasks
1. restate the current entry condition for each boundary family
2. compare the required runtime gap for each family
3. estimate which family needs the smallest new capability to enter real-sample scope
### Deliverables
1. boundary-family comparison matrix
2. smallest-entry-cost summary
### Acceptance Criteria
1. the next candidate family can be justified with explicit criteria
2. the rejected families have explicit hold reasons
## Phase 2: Select One Next Candidate or Hold All
### Objective
Reduce the next-step ambiguity to a single bounded decision.
### Tasks
1. select exactly one family as the next real-sample entry candidate
2. or explicitly conclude that all boundary families remain held
3. record why the non-selected families remain out of scope
### Deliverables
1. boundary-family entry decision
2. hold reasons for non-selected families
### Acceptance Criteria
1. no more than one next family is opened
2. the decision is bounded and defensible
## Phase 3: Publish the Next Bounded Execution Slice
### Objective
Turn the decision into the next actionable bounded plan.
### Tasks
1. if one family is selected, write a bounded `design + plan` for its minimum real-sample entry slice
2. if none is selected, write a bounded prerequisites plan instead
3. update the decision report layer
### Deliverables
1. next-family bounded `design`
2. next-family bounded `plan`
3. roadmap closure report
### Acceptance Criteria
1. the next step is ready to execute without reopening roadmap scope
2. only one bounded direction is emitted
## Completion Criteria
This roadmap is complete when:
1. the post-mainline next step is reduced to one bounded direction
2. `G6 / G7 / G8` no longer compete ambiguously for priority
3. a single follow-up `design + plan` exists for the selected direction
## Next Step
After this roadmap completes:
1. execute the selected family-entry slice if one family is admitted
2. otherwise execute the bounded prerequisites slice before any boundary family enters real-sample scope