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

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

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