Files
claw/docs/superpowers/specs/2026-04-19-g3-enrichment-request-closure-design.md

2.2 KiB

G3 Enrichment Request Closure Design

Date: 2026-04-19 Status: Draft Parent Framework Plan: docs/superpowers/plans/2026-04-19-scene-skill-102-full-coverage-framework-plan.md Parent Route: Route 2: G3 / paginated_enrichment Parent Layer: Layer C + Layer D

Intent

Reduce the largest repeated G3 / paginated_enrichment fail-closed subgroup by recovering missing enrichment-request contract evidence without relaxing gates.

Fixed Input Bucket

Primary bucket:

paginated_enrichment + g3_enrichment_contract + secondary_request

This child plan targets the repeated scenes whose structured fail-closed state shows:

  1. g3_enrichment_contract_complete failed
  2. request/response contract failed because secondary_request is missing

Current Pattern

The current follow-up assets show a repeated subgroup where:

  1. a main paginated scene is recognized
  2. primary request shape is sufficiently visible to classify as paginated_enrichment
  3. enrichment request extraction is not closed
  4. secondary response extraction is not closed

This is the first recovery slice because it appears more frequently than the export-plan-specific slice.

Allowed Files

  1. src/generated_scene/analyzer.rs
  2. src/generated_scene/generator.rs
  3. src/generated_scene/ir.rs
  4. tests/scene_generator_test.rs
  5. route-local sweep follow-up assets created by this plan
  6. route-local reports created by this plan

Forbidden Files

  1. tests/fixtures/generated_scene/scene_execution_board_2026-04-18.json
  2. unrelated family manifests and promotion assets
  3. Route 3, Route 4, Route 5, and Route 6 plan files

Expected Delta

Expected delta is measured only against the Route 2 bucket:

  1. some paginated_enrichment fail-closed records should move from g3_enrichment_contract to either:
    • auto-pass, or
    • a narrower remaining contract blocker
  2. no current G3 canonical or real-sample pass may regress

Stop Rule

Stop after:

  1. the targeted subgroup is rerun in a bounded way
  2. coverage delta is measured
  3. remaining unresolved G3 fail-closed scenes are left for the next Route 2 child plan

Do not absorb export-plan-specific work into this plan unless it is strictly required to preserve contract coherence for the targeted subgroup.