Combine Level 11 runtime direction setup and add move-not-delete roadmap guard

BUILD_PR_LEVEL_11_2_COMBINED_RUNTIME_DIRECTION_AND_RULE_MOVE_GUARDS

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -1,27 +1,30 @@
-
 MODEL: GPT-5.4
 REASONING: high
 
 COMMAND:
-Create `BUILD_PR_LEVEL_11_1_POST_LEVEL_10_HANDOFF_AND_ROADMAP_RULE_CLEANUP`
-
-1. Update roadmap:
-   - remove Productization Rule checkbox section
-   - do NOT alter other roadmap text
-   - status markers only otherwise
-
-2. Update PROJECT_INSTRUCTIONS.md:
-   add:
-
-   ## Productization Rules
-   - Do not create standalone showcase tracks in future roadmaps
-   - Fold showcase importance into the main feature or sample title when needed
-
-3. Confirm Level 10 is complete (status only updates if needed)
-
-4. Package:
-<project folder>/tmp/BUILD_PR_LEVEL_11_1_POST_LEVEL_10_HANDOFF_AND_ROADMAP_RULE_CLEANUP.zip
-
-Rules:
-- no code
-- no scope expansion
+Create `BUILD_PR_LEVEL_11_2_COMBINED_RUNTIME_DIRECTION_AND_RULE_MOVE_GUARDS` as one combined Level 11 setup PR.
+
+Goals:
+1. Define and prepare the next core runtime direction in one compact PR.
+2. Add an explicit migration guard for any future roadmap/instruction cleanup.
+
+Required rules:
+- if roadmap content is being moved to PROJECT_INSTRUCTIONS.md, MOVE it; do not simply delete it
+- destination text must exist before source text is removed
+- preserve wording unless the PR explicitly requires rewriting
+- roadmap handling remains status-only unless explicitly requested otherwise
+- do not delete roadmap content during cleanup work
+
+Outputs:
+- compact PR doc
+- any required docs updates for Level 11 direction
+- validation notes
+- repo-structured ZIP
+
+Final packaging step is REQUIRED:
+`<project folder>/tmp/BUILD_PR_LEVEL_11_2_COMBINED_RUNTIME_DIRECTION_AND_RULE_MOVE_GUARDS.zip`
+
+Hard rules:
+- combine work to reduce PR count
+- no unrelated repo changes
+- no missing ZIP

docs/dev/COMMIT_COMMENT.txt

@@ -1,2 +1,2 @@
-Start Level 11 and move productization rules out of roadmap into instructions
-BUILD_PR_LEVEL_11_1_POST_LEVEL_10_HANDOFF_AND_ROADMAP_RULE_CLEANUP
+Combine Level 11 runtime direction setup and add move-not-delete roadmap guard
+BUILD_PR_LEVEL_11_2_COMBINED_RUNTIME_DIRECTION_AND_RULE_MOVE_GUARDS

docs/dev/NEXT_COMMAND.txt

@@ -1 +1 @@
-PLAN_PR_LEVEL_11_2_CORE_RUNTIME_DIRECTION
+BUILD_PR_LEVEL_11_3_COMBINED_RUNTIME_FOUNDATION

docs/dev/PROJECT_INSTRUCTIONS.md

@@ -112,3 +112,10 @@ ZIP STANDARD (ENFORCED)
 ## Productization Rules
 - Do not create standalone showcase tracks in future roadmaps
 - Fold showcase importance into the main feature or sample title when needed
+
+## Roadmap Instruction Move Guards
+- If roadmap content is moved to `PROJECT_INSTRUCTIONS.md`, move it and do not delete it without relocation.
+- Ensure destination text exists before removing the source text.
+- Preserve wording unless the PR explicitly requires rewriting.
+- Keep roadmap handling status-only unless explicitly requested otherwise.
+- Do not delete roadmap content during cleanup work.

docs/dev/reports/change_summary.txt

@@ -1,3 +1,3 @@
-- Level 11 start
-- roadmap rule cleanup
-- instructions updated
+- Combined the next Level 11 setup work to reduce PR count
+- Added explicit move-not-delete guard for future roadmap/instruction migrations
+- Kept roadmap handling status-only unless explicitly requested otherwise

docs/dev/reports/validation_checklist.txt

@@ -1,4 +1,6 @@
-
-- roadmap cleaned of rule checkboxes
-- instructions updated
-- Level 10 confirmed complete
+- Combined PR reduces follow-on PR count
+- Rule-migration guard is explicit
+- Roadmap cleanup cannot silently delete moved content
+- Outputs remain docs-first and repo-structured
+- Output ZIP created at:
+  <project folder>/tmp/BUILD_PR_LEVEL_11_2_COMBINED_RUNTIME_DIRECTION_AND_RULE_MOVE_GUARDS.zip

docs/dev/roadmaps/MASTER_ROADMAP_HIGH_LEVEL.md

@@ -609,7 +609,7 @@
 - [.] FEATURE: Fullscreen Bezel Overlay System - Render game in full screen with optional bezel artwork layer (static or animated) surrounding the active playfield, preserving aspect ratio and supporting per-game/theme bezel assets without modifying core engine rendering.
 
 ### Later Capability Lanes
-- [ ] Execute 2D capability polish lanes
+- [.] Execute 2D capability polish lanes
 - [ ] Execute phase-16 / 3D capability lanes
 
 ### Final Cleanup Lane

docs/pr/BUILD_PR_LEVEL_11_2_COMBINED_RUNTIME_DIRECTION_AND_RULE_MOVE_GUARDS.md

@@ -0,0 +1,33 @@
+# BUILD_PR_LEVEL_11_2_COMBINED_RUNTIME_DIRECTION_AND_RULE_MOVE_GUARDS
+
+## Purpose
+Combined Level 11 setup PR that sets the next runtime direction and adds explicit move-guard governance for roadmap-to-instructions cleanup.
+
+## Scope
+- docs-only, no runtime code
+- one compact direction/status update
+- one explicit rule-move guard update
+
+## Packaging
+`<project folder>/tmp/BUILD_PR_LEVEL_11_2_COMBINED_RUNTIME_DIRECTION_AND_RULE_MOVE_GUARDS.zip`
+
+## Applied Delta
+
+### 1) Core Runtime Direction (compact)
+- Updated one roadmap status marker to establish active direction:
+  - `- [ ] Execute 2D capability polish lanes`
+  - `+ [.] Execute 2D capability polish lanes`
+
+### 2) Rule-Move Guards
+- Added `## Roadmap Instruction Move Guards` in `docs/dev/PROJECT_INSTRUCTIONS.md` with explicit rules:
+  - move content instead of deleting during roadmap-to-instruction migration
+  - destination text must exist before source removal
+  - preserve wording unless rewrite is explicitly requested
+  - roadmap remains status-only unless explicitly requested
+  - no roadmap-content deletion during cleanup work
+
+## Validation Notes
+- Confirmed only status marker changes were made in roadmap content.
+- Confirmed no roadmap prose was rewritten.
+- Confirmed move-guard rules now exist in `docs/dev/PROJECT_INSTRUCTIONS.md`.
+- Confirmed docs-only scope (no engine/runtime/tool code edits).