claw/docs/superpowers/specs/2026-04-19-official-board-reconciliation-design.md

Official Board Reconciliation Design

Date: 2026-04-19 Parent Framework: 2026-04-19-scene-skill-102-full-coverage-framework-design.md Parent Layer: Layer E Status: Active

Intent

Apply the final 102-scene coverage rollup to the official execution board in a controlled, auditable way.

This design is the only point where scene_execution_board_2026-04-18.json may be updated from the final coverage rollup.

Inputs

1. tests/fixtures/generated_scene/final_coverage_status_rollup_2026-04-19.json
2. tests/fixtures/generated_scene/promotion_board_reconciliation_policy_2026-04-19.json
3. tests/fixtures/generated_scene/scene_execution_board_2026-04-18.json

Outputs

1. updated tests/fixtures/generated_scene/scene_execution_board_2026-04-18.json
2. tests/fixtures/generated_scene/official_board_reconciliation_2026-04-19.json
3. docs/superpowers/reports/2026-04-19-official-board-reconciliation-report.md

Status Mapping

1. framework-auto-pass-candidate maps to framework-auto-pass.
2. framework-structured-fail-closed maps to framework-structured-fail-closed.
3. framework-valid-host-bridge maps to framework-valid-host-bridge.
4. unresolved raw statuses remain explicit and must not be collapsed.

Board Fields

The reconciliation may add or update only current framework fields:

1. currentFrameworkStatus
2. currentFrameworkArchetype
3. currentFrameworkReadiness
4. currentFrameworkSource
5. currentFrameworkDecisionOverlay
6. currentFrameworkNextAction
7. currentFrameworkCanAutoUpdateBoard

Existing frozen workbook snapshot fields must be preserved.

Boundary

This design must not:

1. modify src/generated_scene/analyzer.rs;
2. modify src/generated_scene/generator.rs;
3. rerun the 102 sweep;
4. promote real-sample validation status;
5. remove existing snapshot fields from the board.

Acceptance Criteria

1. Official board still contains exactly 102 scenes.
2. Final framework status counts are 95 framework auto-pass and 7 structured fail-closed.
3. No unresolved framework status remains.
4. Reconciliation JSON records all updated scenes.
5. Report explains the remaining 7 residuals and the next roadmap inputs.