docs: rebaseline roadmap and stage later repo cleanup targets including templates/ deferment

DavidQ · DavidQ · commit 8e770dc9579a · 2026-04-12T14:32:39.000-04:00
diff --git a/docs/dev/CODEX_COMMANDS.md b/docs/dev/CODEX_COMMANDS.md
@@ -2,17 +2,15 @@ MODEL: GPT-5.4
 REASONING: high
 
 COMMAND:
-Create BUILD_PR_DEBUG_INSPECTOR_TOOLS
+Create PLAN_PR_REPO_CLEANUP_AND_ROADMAP_UPDATE as a docs-only package.
 
 Scope:
-- add state inspector tool
-- add replay visualizer tool
-- add basic performance profiler
-- integrate with tool host
-
-Validation:
-- npm run test:launch-smoke -- --tools
-- verify tools launch and inspect data
+- commit updated master roadmap with conservative status rebaseline
+- add tracked cleanup item for templates/ with explicit deferment
+- document cleanup targets and sequencing
+- do not delete or move templates/
+- do not implement cleanup in this PR
+- keep this bundle docs-only
 
 Output:
-<project>/tmp/BUILD_PR_DEBUG_INSPECTOR_TOOLS_delta.zip
+<project folder>/tmp/PLAN_PR_REPO_CLEANUP_AND_ROADMAP_UPDATE.zip
diff --git a/docs/dev/COMMIT_COMMENT.txt b/docs/dev/COMMIT_COMMENT.txt
@@ -1 +1 @@
-chore: enforce docs path rules + roadmap location guard
+docs: rebaseline roadmap and stage later repo cleanup targets including templates/ deferment
diff --git a/docs/dev/reports/PLAN_PR_REPO_CLEANUP_AND_ROADMAP_UPDATE_report.md b/docs/dev/reports/PLAN_PR_REPO_CLEANUP_AND_ROADMAP_UPDATE_report.md
@@ -0,0 +1,29 @@
+# PLAN_PR_REPO_CLEANUP_AND_ROADMAP_UPDATE Report
+
+## Bundle Type
+- Docs-only planning package.
+- No code/runtime/tool implementation changes.
+- No deletion or movement of `templates/`.
+
+## Scope Applied
+- Updated master roadmap with a conservative status rebaseline marker.
+- Added explicit tracked deferment language for `templates/` cleanup.
+- Documented cleanup targets and sequencing for a later dedicated cleanup lane.
+
+## templates/ Constraint
+- `templates/` is tracked for evaluation only.
+- This bundle performs no `templates/` deletion, movement, or implementation work.
+
+## Cleanup Sequencing (Documented, Deferred)
+1. Inventory legacy/transitional folders.
+2. Verify live references.
+3. Classify keep vs move vs future-delete.
+4. Run smoke validation before/after cleanup PRs.
+5. Execute only through exact-scope cleanup PRs.
+
+## Exact Files Included
+- `docs/pr/PLAN_PR_REPO_CLEANUP_AND_ROADMAP_UPDATE.md`
+- `docs/dev/roadmaps/MASTER_ROADMAP_HIGH_LEVEL.md`
+- `docs/dev/reports/repo_cleanup_targets.txt`
+- `docs/dev/reports/roadmap_status_delta.txt`
+- `docs/dev/reports/PLAN_PR_REPO_CLEANUP_AND_ROADMAP_UPDATE_report.md`
diff --git a/docs/dev/reports/repo_cleanup_targets.txt b/docs/dev/reports/repo_cleanup_targets.txt
@@ -0,0 +1,15 @@
+REPO CLEANUP TARGETS (PLANNED, NOT EXECUTED)
+
+Track now, defer action:
+- templates/
+- SpriteEditor_old_keep policy
+- classes_old_keep policy
+- archived notes policy
+- imports pointing to legacy paths
+- eventual legacy retirement roadmap
+
+Rules:
+- no deletion without reference verification
+- no movement without target-home decision
+- no cleanup mixed into active feature lanes
+- smoke validation before/after cleanup PRs
diff --git a/docs/dev/reports/roadmap_status_delta.txt b/docs/dev/reports/roadmap_status_delta.txt
@@ -0,0 +1,24 @@
+ROADMAP STATUS DELTA INCLUDED IN THIS BUNDLE
+
+Advanced to in-progress:
+- StateInspectorTool
+- ReplayVisualizerTool
+- PerformanceProfilerTool
+- AssetPipelineTool
+- Tile/Model Converter Tool
+- content pipeline tools after asset complexity justifies them
+- debug tools align with engine/debug maturity
+- move/refactor validation strategy documented
+- legacy inventory completed
+- keep vs migrate vs future-delete decisions recorded
+- SpriteEditor_old_keep policy defined
+- roadmap for eventual legacy retirement defined
+- Normalize assets/data ownership
+- Expand testing/validation structure
+- re-baseline this roadmap after active execution lanes stabilize
+
+Advanced to complete:
+- smoke validation aligned to samples/tools/games
+
+New tracked cleanup item:
+- templates/ folder evaluated for keep vs move vs future-delete during cleanup phase
diff --git a/docs/dev/roadmaps/MASTER_ROADMAP_HIGH_LEVEL.md b/docs/dev/roadmaps/MASTER_ROADMAP_HIGH_LEVEL.md
@@ -5,6 +5,11 @@
 - [.] in progress
 - [ ] planned
 
+## Conservative Rebaseline (2026-04-12)
+- status updates in this revision are conservative and execution-backed
+- recent tool-host, asset-pipeline, debug-inspector, and launch-smoke lanes are reflected without broad scope expansion
+- `templates/` cleanup is explicitly tracked and deferred to a dedicated cleanup-only lane
+
 ---
 
 ## Strategic Layer
@@ -559,7 +564,7 @@
 - [ ] archived notes policy defined
 - [ ] imports pointing to legacy paths reduced
 - [.] roadmap for eventual legacy retirement defined
-- [ ] `templates/` folder evaluated for keep vs move vs future-delete during cleanup phase
+- [ ] `templates/` folder evaluated for keep vs move vs future-delete during cleanup phase (explicitly deferred in this docs-only bundle)
 
 ---
 
@@ -601,6 +606,7 @@
 
 ### Final Cleanup Lane
 - [ ] Reduce legacy footprint after replacements are proven
+- [ ] Execute `templates/` keep-vs-move-vs-future-delete decision in a dedicated cleanup PR (deferred here; no movement/deletion in this bundle)
 
 ### Recommended Final Status Summary
 - [.] current active execution lanes are 3 / 6 / 8
diff --git a/docs/gdd/King_of_the_Iceberg_GDD_FULL.md b/docs/gdd/King_of_the_Iceberg_GDD_FULL.md
diff --git a/docs/gdd/King_of_the_Iceberg_missing.txt b/docs/gdd/King_of_the_Iceberg_missing.txt
diff --git a/docs/pr/PLAN_PR_REPO_CLEANUP_AND_ROADMAP_UPDATE.md b/docs/pr/PLAN_PR_REPO_CLEANUP_AND_ROADMAP_UPDATE.md

Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-chore: enforce docs path rules + roadmap location guard`
	`1`	`+docs: rebaseline roadmap and stage later repo cleanup targets including templates/ deferment`