Files
claw/docs/superpowers/specs/2026-04-19-structured-fail-closed-residual-13-closure-design.md

4.1 KiB

Structured Fail-Closed Residual 13 Closure Design

Date: 2026-04-19 Status: Draft Parent Framework: docs/superpowers/plans/2026-04-19-scene-skill-102-full-coverage-framework-plan.md Parent Layer: Layer C and Layer D Upstream Asset: tests/fixtures/generated_scene/full_coverage_reconciliation_candidates_2026-04-19.json

Intent

Close or explicitly defer the remaining 13 framework-structured-fail-closed scenes after the 102 full-coverage follow-up sweep.

This design does not update the official execution board. It defines how the remaining residual bucket must be split before any implementation work starts.

Current Residual Bucket

The current residual bucket contains 13 scenes:

Archetype Count Direction
paginated_enrichment 4 mainline residual closure
multi_mode_request 2 mainline residual closure
local_doc_pipeline 5 boundary hold or future G8 runtime roadmap
host_bridge_workflow 1 boundary hold or future G6 runtime roadmap
page_state_eval 1 bootstrap target isolation

Fixed Residual Scenes

Scene ID Scene Archetype Reason
sweep-007-scene 95598供电服务月报 paginated_enrichment workflow evidence incomplete
sweep-018-scene 白银线损周报 multi_mode_request readiness not A/B
sweep-033-scene 供电可靠率指标统计表 local_doc_pipeline workflow evidence incomplete
sweep-034-scene 供电可靠性数据质量自查报告月报 local_doc_pipeline workflow evidence incomplete
sweep-039-scene 故障报修工单信息统计表 paginated_enrichment workflow evidence incomplete
sweep-042-scene 国网金昌供电公司营商环境周例会报告 local_doc_pipeline workflow evidence incomplete
sweep-051-scene 嘉峪关可靠性分析报告 local_doc_pipeline workflow evidence incomplete
sweep-068-scene 输变电设备运行分析报告 paginated_enrichment workflow evidence incomplete
sweep-071-scene 台区线损大数据-月_周累计线损率统计分析 multi_mode_request readiness not A/B
sweep-074-scene 同兴智能安全督查日报 local_doc_pipeline workflow evidence incomplete
sweep-084-scene 巡视计划完成情况自动检索 paginated_enrichment workflow evidence incomplete
sweep-085-scene 业扩报装管理制度 host_bridge_workflow workflow evidence incomplete
sweep-091-scene 用户停电频次分析监测 page_state_eval readiness not A/B

Route Mapping

This residual bucket must be split into bounded child work:

  1. Residual Route A: G3 / paginated_enrichment residual closure for 4 scenes.
  2. Residual Route B: G2 / multi_mode_request residual closure for 2 scenes.
  3. Residual Route C: boundary hold decision for local-doc and host-bridge residuals.
  4. Residual Route D: bootstrap target isolation for the page-state residual.
  5. Residual Route E: follow-up mini sweep and reconciliation candidate refresh.

Guardrails

  1. Do not update tests/fixtures/generated_scene/scene_execution_board_2026-04-18.json.
  2. Do not add new families.
  3. Do not start G4/G5.
  4. Do not relax readiness gates.
  5. Do not merge boundary runtime work with mainline contract closure.
  6. Do not classify local-doc residuals as mainline pass without a separate G8 runtime roadmap.
  7. Do not classify host-bridge residuals as mainline pass without a separate G6 runtime roadmap.

Implementation Boundaries

Allowed implementation routes:

  1. G3 residual workflow evidence recovery.
  2. G2 residual request/response/mode readiness correction.

Decision-only routes:

  1. local_doc_pipeline residuals.
  2. host_bridge_workflow residual.
  3. page_state_eval/bootstrap_target residual.

Completion Criteria

This residual design is complete when:

  1. all 13 scenes are assigned to one residual route;
  2. the mainline residual routes have bounded implementation plans;
  3. boundary and bootstrap residuals have explicit hold/isolate decisions;
  4. a follow-up mini sweep plan exists to measure the residual closure delta.