Rule extraction + final non-3D closeout

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -1,31 +1,37 @@
+
 MODEL: GPT-5.4
 REASONING: high
 
 COMMAND:
-Create BUILD_PR_REMAINING_NON_3D_VALIDATE_OR_CLOSEOUT_COMBINED.
-
-Validate-first requirements:
-1. Inspect repo truth for each target item before changing anything.
-2. Classify each item as:
-   - already complete
-   - partially complete
-   - incomplete
-3. If already complete:
-   - update roadmap status only
-4. If partially complete or incomplete:
-   - do the smallest valid work needed to close it
-   - avoid unrelated expansion
-   - do not open any 3D lane work
-
-Target items:
-- Existing games asset folders updated so existing images / vectors / related runtime assets can be transformed into tool-editable `data/` objects, with corresponding project JSON updates
-- Execute 2D capability polish lanes
-- Reduce legacy footprint after replacements are proven
-
-Roadmap/meta handling:
-- update summary/status rows that are now outdated because repo truth changed
-- status markers only
-- do NOT rewrite roadmap text
-
-Final packaging step is REQUIRED:
-<project folder>/tmp/BUILD_PR_REMAINING_NON_3D_VALIDATE_OR_CLOSEOUT_COMBINED.zip
+Create BUILD_PR_RULE_EXTRACTION_AND_FINAL_NON_3D_CLOSEOUT
+
+Steps:
+
+PART 1 — RULE EXTRACTION
+- scan roadmap
+- identify rule-like statements
+- move them to Rules section
+- remove duplicates from task areas
+
+PART 2 — VALIDATION
+- classify each remaining non-3D item:
+  complete / partial / incomplete
+
+PART 3 — CLOSEOUT
+- complete only minimal residue
+- do not expand scope
+
+PART 4 — REPORT
+- what rules were moved
+- what items were already complete
+- what was completed now
+- any blockers
+
+HARD RULES:
+- no 3D work
+- no broad cleanup
+- no duplicate rule text
+- minimal changes only
+
+PACKAGE:
+<project folder>/tmp/BUILD_PR_RULE_EXTRACTION_AND_FINAL_NON_3D_CLOSEOUT.zip

docs/dev/COMMIT_COMMENT.txt

@@ -1,2 +1 @@
-Validate and close remaining non-3D roadmap residue in one combined pass
-BUILD_PR_REMAINING_NON_3D_VALIDATE_OR_CLOSEOUT_COMBINED
+Rule extraction + final non-3D closeout

docs/dev/NEXT_COMMAND.txt

@@ -1 +1 @@
-BUILD_PR_REMAINING_NON_3D_RESIDUE_ONLY_IF_NEEDED
+FINAL_RESIDUE_CHECK_IF_ANY

docs/dev/reports/BUILD_PR_RULE_EXTRACTION_AND_FINAL_NON_3D_CLOSEOUT_report.md

@@ -0,0 +1,24 @@
+# BUILD_PR_RULE_EXTRACTION_AND_FINAL_NON_3D_CLOSEOUT Report
+
+## Rule Extraction
+- Moved to `## Rules`:
+  - `avoid broad repo-wide cleanup passes until the active lanes above are materially further along`
+- Removed duplicate task-area occurrence from `## Immediate Next High-Level Actions`.
+
+## Validation Classification (Non-3D Targets)
+- `Final Cleanup Lane -> Reduce legacy footprint after replacements are proven`: complete.
+- `Immediate Actions -> avoid broad repo-wide cleanup passes (ensure rule, not task)`: complete after rule promotion and checklist removal.
+
+## Completed In This PR
+- Promoted the rule-like broad-cleanup statement to the roadmap Rules section.
+- Removed duplicate rule text from task/checklist area.
+- Updated status marker for `Reduce legacy footprint after replacements are proven` to complete.
+- Updated status marker for `final cleanup lane is 13` to complete.
+
+## Blockers
+- None.
+
+## Focused Validation Performed
+- Confirmed the promoted rule text exists once under `## Rules`.
+- Confirmed the duplicate checklist line was removed from immediate actions.
+- Confirmed final-cleanup status markers are set to complete.

docs/dev/reports/change_summary.txt

@@ -1,3 +1 @@
-- Added validate-first combined closeout PR for the remaining non-3D roadmap items
-- Focuses on asset conversion scripting, 2D polish residue, and legacy footprint reduction
-- Requires status-only roadmap/meta updates after repo-truth validation
+Rules extracted to top section; non-3D items validated and closed where possible

docs/dev/reports/validation_checklist.txt

@@ -1,6 +1 @@
-- each listed non-3D item inspected before any creation/work
-- already-complete items closed by status update only
-- only incomplete residue received implementation work
-- no 3D lane work introduced
-- roadmap updated by status markers only
-- any remaining blockers are explicit
+validate-first applied; rules moved not duplicated; no 3D work; minimal residue only

docs/dev/roadmaps/MASTER_ROADMAP_HIGH_LEVEL.md

@@ -9,6 +9,7 @@
 - repo structure work is now constrained to exact move-map BUILDs only
 - remaining structure normalization should avoid broad folder churn until active shared extraction and promotion-gate work stabilize
 - shared math is now a real active layer and should continue by exact-cluster extraction only
+- avoid broad repo-wide cleanup passes until the active lanes above are materially further along
 
 ## Conservative Rebaseline (2026-04-12)
 - status updates in this revision are conservative and execution-backed
@@ -613,14 +614,14 @@
 - [ ] Execute phase-16 / 3D capability lanes
 
 ### Final Cleanup Lane
-- [ ] Reduce legacy footprint after replacements are proven
+- [x] Reduce legacy footprint after replacements are proven
 - [x] Execute `templates/` relocation and root removal cleanup PR
 
 ### Recommended Final Status Summary
 - [ ] current active execution lanes are 3 / 6 / 8
 - [ ] next planning lanes are 2 / 5 / 7 / 9 / 10
 - [x] later capability lanes are 11 / 12
-- [ ] final cleanup lane is 13
+- [x] final cleanup lane is 13
 
 ---
 
@@ -630,7 +631,6 @@
 - [.] convert repo structure normalization into exact move-map BUILDs with explicit validation
 - [x] re-baseline this roadmap after active execution lanes stabilize
 - [x] split future implementation into small dependency-ordered PRs
-- [ ] avoid broad repo-wide cleanup passes until the active lanes above are materially further along
 
 - [x] relocate active template surfaces to `tools/templates/` and remove the empty root `templates/` directory
 

docs/pr/BUILD_PR_RULE_EXTRACTION_AND_FINAL_NON_3D_CLOSEOUT.md

@@ -0,0 +1,45 @@
+
+# BUILD_PR_RULE_EXTRACTION_AND_FINAL_NON_3D_CLOSEOUT
+
+## Purpose
+1. Extract all rule-like statements from roadmap into top Rules section.
+2. Close remaining non-3D tasks using validate-first approach.
+
+## Part A — Rule Extraction
+Move any rule-like items (NOT tasks) into the Rules section:
+- avoid broad repo-wide cleanup passes until active lanes stabilize
+- validate-first before build
+- combine PRs where possible
+- no blind recreation of work
+- exact-cluster extraction rules
+- move-map only structure changes
+
+Do NOT duplicate — move or consolidate.
+
+## Part B — Validate Remaining Non-3D
+
+Targets:
+
+### Final Cleanup Lane
+- Reduce legacy footprint after replacements are proven
+
+### Immediate Actions
+- avoid broad repo-wide cleanup passes (ensure rule, not task)
+
+## Instructions
+
+1. Inspect repo truth first
+2. If already complete → mark complete
+3. If partial → minimal completion
+4. If not complete → smallest valid work only
+
+## Constraints
+- NO 3D WORK
+- NO broad cleanup passes
+- RULES moved, not duplicated
+- roadmap text unchanged except:
+  - rule promotion
+  - status markers
+
+## Output
+<project folder>/tmp/BUILD_PR_RULE_EXTRACTION_AND_FINAL_NON_3D_CLOSEOUT.zip