claw/docs/superpowers/plans/2026-04-21-generated-scene-runtime-semantics-offline-validation-bundle-refresh-plan.md

Generated Scene Runtime Semantics Offline Validation Bundle Refresh Plan

Date: 2026-04-21

Design:

• docs/superpowers/specs/2026-04-21-generated-scene-runtime-semantics-offline-validation-bundle-refresh-design.md

Upstream plans:

• docs/superpowers/plans/2026-04-21-generated-scene-runtime-semantics-rematerialization-execution-plan.md
• docs/superpowers/plans/2026-04-21-generated-scene-runtime-semantics-validation-refresh-execution-plan.md

Intent

Build a refreshed offline validation bundle from the 2026-04-21 runtime-semantics rematerialized 102-skill set and refreshed validation handoff assets.

This plan only prepares the portable bundle. It does not run pseudo-production validation.

Fixed Inputs

1. examples/scene_skill_102_runtime_semantics_rematerialization_2026-04-21
2. tests/fixtures/generated_scene/generated_scene_runtime_semantics_rematerialization_manifest_2026-04-21.json
3. tests/fixtures/generated_scene/generated_scene_runtime_semantics_rematerialization_failures_2026-04-21.json
4. tests/fixtures/generated_scene/scene_skill_102_runtime_semantics_deterministic_invocation_readiness_2026-04-21.json
5. tests/fixtures/generated_scene/scene_skill_102_runtime_semantics_natural_language_parameter_readiness_2026-04-21.json
6. tests/fixtures/generated_scene/scene_skill_102_runtime_semantics_natural_language_invocation_samples_2026-04-21.json
7. tests/fixtures/generated_scene/scene_skill_102_runtime_semantics_pseudoprod_execution_handoff_2026-04-21.json
8. tests/fixtures/generated_scene/scene_skill_102_runtime_semantics_pseudoprod_evidence_checklist_2026-04-21.json
9. tests/fixtures/generated_scene/scene_skill_102_runtime_semantics_pseudoprod_execution_record_template_2026-04-21.json
10. tests/fixtures/generated_scene/scene_skill_102_runtime_semantics_full_direct_mock_execution_2026-04-21.json
11. target/debug/sg_claw.exe or an equivalent current local sg_claw.exe
12. Optional rule assets:
    • resources/rules-102-business-targets-candidate.json
    • resources/rules-102-business-targets-merged.json
    • resources/rules-102-business-targets.patch

Output Directory

Create:

• dist/sgclaw_102_runtime_semantics_validation_bundle_2026-04-21

Do not delete or mutate:

• dist/sgclaw_102_pseudoprod_validation_bundle_2026-04-20

Phases

Phase 0: Input Verification

1. Confirm the 2026-04-21 rematerialization directory exists.
2. Confirm it contains 102 skill directories.
3. Confirm the 2026-04-21 rematerialization failures asset reports zero failures.
4. Confirm the 2026-04-21 validation refresh assets exist.
5. Confirm the pseudo-production handoff contains the refreshed selected batch.

Phase 1: Bundle Directory Preparation

1. Create the target dist/ bundle directory.
2. Create subdirectories:
   • skills/
   • docs/
   • handoff/
   • resources/
   • results/
   • evidence/
3. Copy sg_claw.exe into the bundle root.
4. Copy the 2026-04-21 rematerialized skills/ content into the bundle.

Phase 2: Documentation And Handoff Copy

1. Copy SCENE_INDEX.md and scene_skill_102_index.json from the 2026-04-21 rematerialization output into docs/.
2. Copy refreshed validation/handoff assets into handoff/.
3. Copy rule candidate assets into resources/ when present.
4. Generate README.md with:
   • config sample using skillsDir
   • browser WebSocket reminder
   • service console execution notes
   • credential safety warning
   • page URL guidance
5. Generate BATCH_001.md from the refreshed pseudo-production handoff selected batch.
6. Generate BUNDLE_MANIFEST.json.

Phase 3: Bundle Validation

1. Confirm skills/ contains 102 scene directories.
2. Confirm every skill directory contains:
   • SKILL.toml
   • SKILL.md
   • scene.toml
   • scripts/
3. Confirm critical JSON files parse.
4. Confirm BATCH_001.md includes the same selected batch count as the handoff.
5. Confirm no credentials or tokens are introduced by the generated bundle docs.

Phase 4: Report

Publish:

• docs/superpowers/reports/2026-04-21-generated-scene-runtime-semantics-offline-validation-bundle-refresh-report.md

The report must include:

1. bundle path
2. copied skill count
3. selected batch count
4. copied handoff assets
5. validation result
6. explicit statement that no pseudo-production execution was run

Allowed Files

1. dist/sgclaw_102_runtime_semantics_validation_bundle_2026-04-21/**
2. docs/superpowers/reports/2026-04-21-generated-scene-runtime-semantics-offline-validation-bundle-refresh-report.md

Forbidden Files

1. No src/ changes
2. No examples/scene_skill_102_runtime_semantics_rematerialization_2026-04-21/** edits
3. No validation asset edits under tests/fixtures/generated_scene/
4. No official board updates
5. No old bundle deletion
6. No credentials or secret material

Stop Statement

Stop after the refreshed offline validation bundle and report are generated and validated.

Do not run browser, inner-network, or pseudo-production validation inside this plan.