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

Local-Doc Official Board Reconciliation Refresh Design

Date: 2026-04-19 Parent Framework: 2026-04-19-scene-skill-102-full-coverage-framework-plan.md Parent Roadmap: 2026-04-19-local-doc-runtime-roadmap-plan.md Layer: Layer E / official board reconciliation

Intent

Consume the five local-doc reconciliation candidates produced by the local-doc runtime roadmap and refresh only their framework status in the official execution board.

This design exists because the local-doc roadmap intentionally stopped before official board update. The board update needs a bounded reconciliation refresh that applies the promotion policy without modifying generation logic.

Fixed Inputs

1. tests/fixtures/generated_scene/local_doc_runtime_reconciliation_candidates_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

Scope

Only these five scene ids are in scope:

1. sweep-033-scene
2. sweep-034-scene
3. sweep-042-scene
4. sweep-051-scene
5. sweep-074-scene

Refresh Rule

If a fixed-scope scene is present in the local-doc candidate asset as framework-auto-pass-candidate, update only framework-layer board fields:

• currentFrameworkStatus
• currentFrameworkCandidateStatus
• currentFrameworkArchetype
• currentFrameworkReadiness
• currentFrameworkSource
• currentFrameworkDecisionOverlay
• currentFrameworkNextAction
• currentFrameworkCanAutoUpdateBoard

Workbook snapshot fields, currentGroup, currentStatus, real-sample fields, and scene names are preserved.

Forbidden Scope

1. Do not modify src/generated_scene/analyzer.rs.
2. Do not modify src/generated_scene/generator.rs.
3. Do not rerun the 102 sweep.
4. Do not update host-bridge residuals.
5. Do not update bootstrap residuals.
6. Do not rename official-board scenes.
7. Do not promote non-framework business status.

Expected Result

The official board framework summary moves from:

• framework-auto-pass = 95
• framework-structured-fail-closed = 7

to:

• framework-auto-pass = 100
• framework-structured-fail-closed = 2

The remaining two structured fail-closed records should be:

• one host-bridge runtime residual;
• one bootstrap target normalization residual.