Final cleanup with template protection and roadmap archival

DavidQ · DavidQ · commit 63462019c784 · 2026-04-18T11:10:33.000-04:00
- removed empty directories excluding games/_template and its subfolders
- removed unnecessary .keep files outside protected template structure
- cleaned docs residue
- renamed MASTER_ROADMAP_HIGH_LEVEL.md to MASTER_ROADMAP_ENGINE.md
- archived docs/operations/dev/BIG_PICTURE_ROADMAP.md
- updated all affected references and pointers
- validated repo integrity
diff --git a/docs/archive/dev-ops/BIG_PICTURE_ROADMAP.md b/docs/archive/dev-ops/BIG_PICTURE_ROADMAP.md
diff --git a/docs/archive/pr/legacy-pr-history/APPLY_PR_BIG_PICTURE_ROADMAP_ENCODING_FIX.md b/docs/archive/pr/legacy-pr-history/APPLY_PR_BIG_PICTURE_ROADMAP_ENCODING_FIX.md
@@ -6,7 +6,7 @@ APPLY_PR_BIG_PICTURE_ROADMAP_ENCODING_FIX.md
 # APPLY_PR_BIG_PICTURE_ROADMAP_ENCODING_FIX
 
 ## Apply Scope
-Apply the approved encoding-only fix for `docs/operations/dev/BIG_PICTURE_ROADMAP.md` and associated docs/dev control/report updates.
+Apply the approved encoding-only fix for `docs/archive/dev-ops/BIG_PICTURE_ROADMAP.md` and associated docs/dev control/report updates.
 
 ## Apply Requirements
 1. Keep roadmap content unchanged.
diff --git a/docs/archive/pr/legacy-pr-history/APPLY_PR_DEBUG_SURFACES_INSPECTORS.md b/docs/archive/pr/legacy-pr-history/APPLY_PR_DEBUG_SURFACES_INSPECTORS.md
@@ -38,7 +38,7 @@ Included contracts:
 - No regressions outside inspector scope
 
 ## Roadmap Update
-Update only bracket states in docs/operations/dev/BIG_PICTURE_ROADMAP.md
+Update only bracket states in docs/archive/dev-ops/BIG_PICTURE_ROADMAP.md
 
 Track I:
 - Entity inspector -> [x]
diff --git a/docs/archive/pr/legacy-pr-history/APPLY_PR_DEBUG_SURFACES_NETWORK_SAMPLE_A.md b/docs/archive/pr/legacy-pr-history/APPLY_PR_DEBUG_SURFACES_NETWORK_SAMPLE_A.md
@@ -13,7 +13,7 @@ Apply the approved Sample A implementation only:
 - update docs/dev controls and reports for this PR
 
 ## Roadmap Updates (Bracket-Only)
-In `docs/operations/dev/BIG_PICTURE_ROADMAP.md`:
+In `docs/archive/dev-ops/BIG_PICTURE_ROADMAP.md`:
 - Connection status panel -> `[x]`
 - Latency / RTT panel -> `[x]`
 - Event tracing -> `[x]`
diff --git a/docs/archive/pr/legacy-pr-history/APPLY_PR_DEBUG_SURFACES_NETWORK_SAMPLE_C_FULL.md b/docs/archive/pr/legacy-pr-history/APPLY_PR_DEBUG_SURFACES_NETWORK_SAMPLE_C_FULL.md
@@ -13,7 +13,7 @@ Apply the docs-first Sample C planning slice and use it as the Codex-ready instr
 - `docs/pr/BUILD_PR_DEBUG_SURFACES_NETWORK_SAMPLE_C_FULL.md`
 - `docs/pr/APPLY_PR_DEBUG_SURFACES_NETWORK_SAMPLE_C_FULL.md`
 - `docs/dev/NETWORK_SAMPLES_PLAN.md`
-- `docs/operations/dev/BIG_PICTURE_ROADMAP.md`
+- `docs/archive/dev-ops/BIG_PICTURE_ROADMAP.md`
 - `docs/operations/dev/codex_commands.md`
 - `docs/operations/dev/commit_comment.txt`
 - `docs/operations/dev/next_command.txt`
diff --git a/docs/archive/pr/legacy-pr-history/BUILD_PR_BIG_PICTURE_ROADMAP_ENCODING_FIX.md b/docs/archive/pr/legacy-pr-history/BUILD_PR_BIG_PICTURE_ROADMAP_ENCODING_FIX.md
@@ -6,7 +6,7 @@ BUILD_PR_BIG_PICTURE_ROADMAP_ENCODING_FIX.md
 # BUILD_PR_BIG_PICTURE_ROADMAP_ENCODING_FIX
 
 ## Build Summary
-Built a surgical encoding-normalization slice for `docs/operations/dev/BIG_PICTURE_ROADMAP.md`.
+Built a surgical encoding-normalization slice for `docs/archive/dev-ops/BIG_PICTURE_ROADMAP.md`.
 
 ## Implemented Changes
 1. Normalized roadmap file write encoding to UTF-8 with BOM.
diff --git a/docs/archive/pr/legacy-pr-history/BUILD_PR_DEBUG_SURFACES_NETWORK_SAMPLE_B.md b/docs/archive/pr/legacy-pr-history/BUILD_PR_DEBUG_SURFACES_NETWORK_SAMPLE_B.md
@@ -41,7 +41,7 @@ Implemented Sample B host/client diagnostics using sample-owned fake peer simula
 
 6. Roadmap/checklist updates
 - updated Track O items in `docs/dev/NETWORK_SAMPLES_PLAN.md` to complete
-- no required changes to `docs/operations/dev/BIG_PICTURE_ROADMAP.md`
+- no required changes to `docs/archive/dev-ops/BIG_PICTURE_ROADMAP.md`
 
 ## Scope Safety
 - no src/engine/core changes
diff --git a/docs/archive/pr/legacy-pr-history/BUILD_PR_DEBUG_SURFACES_NETWORK_SAMPLE_C_FULL.md b/docs/archive/pr/legacy-pr-history/BUILD_PR_DEBUG_SURFACES_NETWORK_SAMPLE_C_FULL.md
@@ -11,7 +11,7 @@ Prepared the next docs-first implementation package for the Level 11 network seq
 ## Deliverables In This Bundle
 1. PR planning docs for Sample C full implementation
 2. Updated `docs/dev/NETWORK_SAMPLES_PLAN.md`
-3. Roadmap guidance for `docs/operations/dev/BIG_PICTURE_ROADMAP.md`
+3. Roadmap guidance for `docs/archive/dev-ops/BIG_PICTURE_ROADMAP.md`
 4. Codex command, commit comment, next command, and validation reports
 
 ## Implementation Direction
diff --git a/docs/archive/pr/legacy-pr-history/BUILD_PR_DEBUG_SURFACES_NETWORK_SUPPORT.md b/docs/archive/pr/legacy-pr-history/BUILD_PR_DEBUG_SURFACES_NETWORK_SUPPORT.md
@@ -42,7 +42,7 @@ Built the full docs-first network debug support path for multiplayer diagnostics
 - Preserve debug-only gating.
 
 ## Roadmap State
-Bracket-only update in `docs/operations/dev/BIG_PICTURE_ROADMAP.md`:
+Bracket-only update in `docs/archive/dev-ops/BIG_PICTURE_ROADMAP.md`:
 - `BUILD_PR_DEBUG_SURFACES_NETWORK_SUPPORT` -> `[x]`
 
 ## Scope Safety
diff --git a/docs/archive/pr/legacy-pr-history/PLAN_PR_BIG_PICTURE_ROADMAP_ENCODING_FIX.md b/docs/archive/pr/legacy-pr-history/PLAN_PR_BIG_PICTURE_ROADMAP_ENCODING_FIX.md
@@ -6,13 +6,13 @@ PLAN_PR_BIG_PICTURE_ROADMAP_ENCODING_FIX.md
 # PLAN_PR_BIG_PICTURE_ROADMAP_ENCODING_FIX
 
 ## Goal
-Normalize `docs/operations/dev/BIG_PICTURE_ROADMAP.md` encoding so the file renders consistently across Windows tooling without changing roadmap content or bracket states.
+Normalize `docs/archive/dev-ops/BIG_PICTURE_ROADMAP.md` encoding so the file renders consistently across Windows tooling without changing roadmap content or bracket states.
 
 ## Workflow
 PLAN_PR -> BUILD_PR -> APPLY_PR
 
 ## In Scope
-- Encoding normalization for `docs/operations/dev/BIG_PICTURE_ROADMAP.md`.
+- Encoding normalization for `docs/archive/dev-ops/BIG_PICTURE_ROADMAP.md`.
 - Validation that bracket-state rows remain unchanged.
 - Docs/dev control files and reports for this one PR purpose.
 
diff --git a/docs/archive/pr/legacy-pr-history/PLAN_PR_DEBUG_SURFACES_NETWORK_SAMPLE_C_FULL.md b/docs/archive/pr/legacy-pr-history/PLAN_PR_DEBUG_SURFACES_NETWORK_SAMPLE_C_FULL.md
@@ -20,7 +20,7 @@ PLAN_PR -> BUILD_PR -> APPLY_PR
 - `docs/dev/NETWORK_SAMPLES_PLAN.md`
   - advance Track P to in-progress for Sample C planning
   - keep Track T and Track U visible as upcoming tracks, not falsely marked complete unless code is actually delivered
-- `docs/operations/dev/BIG_PICTURE_ROADMAP.md`
+- `docs/archive/dev-ops/BIG_PICTURE_ROADMAP.md`
   - remove broken icon usage in the relevant network/debug roadmap area
   - keep text-only headings for Track T and Track U
   - align Level 11 / Phase 13 wording with the network sample sequence
diff --git a/docs/archive/pr/legacy-pr-history/PLAN_PR_DEBUG_SURFACES_NETWORK_SERVER_CONTAINER.md b/docs/archive/pr/legacy-pr-history/PLAN_PR_DEBUG_SURFACES_NETWORK_SERVER_CONTAINER.md
@@ -40,4 +40,4 @@ PLAN_PR -> BUILD_PR -> APPLY_PR
 - Environment variables are documented and supported.
 - Optional compose example is provided.
 - Track U checklist items in `docs/dev/NETWORK_SAMPLES_PLAN.md` move to `[.]` or `[x]`.
-- `docs/operations/dev/BIG_PICTURE_ROADMAP.md` remains unchanged.
+- `docs/archive/dev-ops/BIG_PICTURE_ROADMAP.md` remains unchanged.
diff --git a/docs/archive/pr/legacy-pr-history/PLAN_PR_DEBUG_SURFACES_NETWORK_SUPPORT.md b/docs/archive/pr/legacy-pr-history/PLAN_PR_DEBUG_SURFACES_NETWORK_SUPPORT.md
@@ -14,7 +14,7 @@ PLAN_PR -> BUILD_PR -> APPLY_PR
 ## In Scope
 - Network debug support plan, build contract, and apply contract.
 - `docs/dev/NETWORK_SAMPLES_PLAN.md` staged execution model.
-- Bracket-only updates to `docs/operations/dev/BIG_PICTURE_ROADMAP.md` Track G state markers.
+- Bracket-only updates to `docs/archive/dev-ops/BIG_PICTURE_ROADMAP.md` Track G state markers.
 
 ## Out Of Scope
 - Engine-core implementation changes.
diff --git a/docs/archive/pr/legacy-pr-history/PLAN_PR_DEBUG_UX_FINAL_POLISH.md b/docs/archive/pr/legacy-pr-history/PLAN_PR_DEBUG_UX_FINAL_POLISH.md
@@ -37,7 +37,7 @@ PLAN_PR -> BUILD_PR -> APPLY_PR
 ## Guardrails
 - Sample-level integration only.
 - No engine core changes.
-- Do not modify `docs/operations/dev/BIG_PICTURE_ROADMAP.md`.
+- Do not modify `docs/archive/dev-ops/BIG_PICTURE_ROADMAP.md`.
 - If `docs/dev/PRODUCTIZATION_ROADMAP.md` changes, bracket-only edits only.
 - No Track G or Track H work.
 
diff --git a/docs/archive/pr/legacy-pr-history/PLAN_PR_NETWORK_SAMPLE_A_INDEX_FIX.md b/docs/archive/pr/legacy-pr-history/PLAN_PR_NETWORK_SAMPLE_A_INDEX_FIX.md
@@ -10,7 +10,7 @@ Finish the Network Sample A index integration safely using the current code base
 - place Network Sample A under `Level 11 - Network Games`
 - add documentation links on the card
 - update `docs/dev/NETWORK_SAMPLES_PLAN.md`
-- apply bracket-only updates to `docs/operations/dev/BIG_PICTURE_ROADMAP.md`
+- apply bracket-only updates to `docs/archive/dev-ops/BIG_PICTURE_ROADMAP.md`
 
 ## Constraints
 - do not add a top showcase section
diff --git a/docs/archive/pr/legacy-pr-history/PLAN_PR_PRODUCTIZATION_ROADMAP.md b/docs/archive/pr/legacy-pr-history/PLAN_PR_PRODUCTIZATION_ROADMAP.md
@@ -19,7 +19,7 @@ PLAN_PR -> BUILD_PR -> APPLY_PR
 
 ## Out of Scope
 - Engine/runtime implementation changes.
-- Any edits to `docs/operations/dev/BIG_PICTURE_ROADMAP.md`.
+- Any edits to `docs/archive/dev-ops/BIG_PICTURE_ROADMAP.md`.
 - Non-roadmap feature work.
 
 ## Guardrails
diff --git a/docs/archive/pr/legacy-pr-history/PLAN_PR_PRODUCTIZATION_ROADMAP_CLOSEOUT.md b/docs/archive/pr/legacy-pr-history/PLAN_PR_PRODUCTIZATION_ROADMAP_CLOSEOUT.md
@@ -17,7 +17,7 @@ PLAN_PR -> BUILD_PR -> APPLY_PR
 - Update docs/pr files, docs/dev control files, and reports for this closeout bundle.
 
 ## Out of Scope
-- `docs/operations/dev/BIG_PICTURE_ROADMAP.md` edits.
+- `docs/archive/dev-ops/BIG_PICTURE_ROADMAP.md` edits.
 - Engine/runtime/UI code changes.
 - Non-roadmap feature work.
 
diff --git a/docs/dev/reports/BIG_PICTURE_ROADMAP_ARCHIVE_MAP.md b/docs/dev/reports/BIG_PICTURE_ROADMAP_ARCHIVE_MAP.md
@@ -0,0 +1,36 @@
+# BIG_PICTURE_ROADMAP_ARCHIVE_MAP
+
+Archive mapping:
+- source: `docs/operations/dev/BIG_PICTURE_ROADMAP.md`
+- destination: `docs/archive/dev-ops/BIG_PICTURE_ROADMAP.md`
+- archived this pass: True
+
+- References updated in this pass: 25
+Updated files:
+- `docs/archive/pr/legacy-pr-history/APPLY_PR_BIG_PICTURE_ROADMAP_ENCODING_FIX.md`
+- `docs/archive/pr/legacy-pr-history/APPLY_PR_DEBUG_SURFACES_INSPECTORS.md`
+- `docs/archive/pr/legacy-pr-history/APPLY_PR_DEBUG_SURFACES_NETWORK_SAMPLE_A.md`
+- `docs/archive/pr/legacy-pr-history/APPLY_PR_DEBUG_SURFACES_NETWORK_SAMPLE_C_FULL.md`
+- `docs/archive/pr/legacy-pr-history/BUILD_PR_BIG_PICTURE_ROADMAP_ENCODING_FIX.md`
+- `docs/archive/pr/legacy-pr-history/BUILD_PR_DEBUG_SURFACES_NETWORK_SAMPLE_B.md`
+- `docs/archive/pr/legacy-pr-history/BUILD_PR_DEBUG_SURFACES_NETWORK_SAMPLE_C_FULL.md`
+- `docs/archive/pr/legacy-pr-history/BUILD_PR_DEBUG_SURFACES_NETWORK_SUPPORT.md`
+- `docs/archive/pr/legacy-pr-history/PLAN_PR_BIG_PICTURE_ROADMAP_ENCODING_FIX.md`
+- `docs/archive/pr/legacy-pr-history/PLAN_PR_DEBUG_SURFACES_NETWORK_SAMPLE_C_FULL.md`
+- `docs/archive/pr/legacy-pr-history/PLAN_PR_DEBUG_SURFACES_NETWORK_SERVER_CONTAINER.md`
+- `docs/archive/pr/legacy-pr-history/PLAN_PR_DEBUG_SURFACES_NETWORK_SUPPORT.md`
+- `docs/archive/pr/legacy-pr-history/PLAN_PR_DEBUG_UX_FINAL_POLISH.md`
+- `docs/archive/pr/legacy-pr-history/PLAN_PR_NETWORK_SAMPLE_A_INDEX_FIX.md`
+- `docs/archive/pr/legacy-pr-history/PLAN_PR_PRODUCTIZATION_ROADMAP.md`
+- `docs/archive/pr/legacy-pr-history/PLAN_PR_PRODUCTIZATION_ROADMAP_CLOSEOUT.md`
+- `docs/dev/codex_commands.md`
+- `docs/dev/commit_comment.txt`
+- `docs/operations/dev/README.md`
+- `docs/operations/dev/ROADMAP_GUARDRAILS.md`
+- `docs/operations/dev/RULES_OF_ENGAGEMENT.md`
+- `docs/pr/BUILD_PR_FINAL_REPO_CLEANUP_AND_ROADMAP_RENAME_V3.md`
+- `docs/reference/features/docs-system/move-history-preserved.md`
+- `docs/reports/docs_classification_matrix.md`
+- `docs/reports/docs_move_map_proposed.md`
+
+- Reachability check (references to archived path): 25 hits
diff --git a/docs/dev/reports/CLEANUP_EMPTY_DIRECTORIES.md b/docs/dev/reports/CLEANUP_EMPTY_DIRECTORIES.md
@@ -0,0 +1,10 @@
+# CLEANUP_EMPTY_DIRECTORIES
+
+Scope:
+- scanned repo for empty directories
+- excluded all paths under `games/` (including all subfolders)
+- excluded infra dirs: `.git/`, `node_modules/`, `tmp/`
+- excluded `docs/dev/start_of_day/` per guardrails
+
+Result: 0 empty directories remain in scanned scope.
+- No removable empty directories found.
diff --git a/docs/dev/reports/CLEANUP_KEEP_FILES.md b/docs/dev/reports/CLEANUP_KEEP_FILES.md
@@ -0,0 +1,9 @@
+# CLEANUP_KEEP_FILES
+
+Scope:
+- scanned for `.keep` files outside protected template structure
+- protected template scope: `games/_template/**`
+- removal rule: orphaned/unnecessary `.keep` only
+
+Result: 0 `.keep` files detected in repo scan output.
+- No `.keep` files found; no action required.
diff --git a/docs/dev/reports/DOCS_RESIDUE_CLEANUP.md b/docs/dev/reports/DOCS_RESIDUE_CLEANUP.md
@@ -0,0 +1,14 @@
+# DOCS_RESIDUE_CLEANUP
+
+Residue targets reviewed:
+- stale references to `docs/dev/roadmaps/MASTER_ROADMAP_HIGH_LEVEL.md`
+- stale references to `docs/operations/dev/BIG_PICTURE_ROADMAP.md`
+- active docs path consistency in `docs/operations/dev/*`
+
+Old-path reference hits after cleanup: 0
+- No residual old-path references found.
+
+Active docs consistency updates applied:
+- `docs/operations/dev/README.md` superseded-roadmap pointer corrected
+- `docs/operations/dev/ROADMAP_GUARDRAILS.md` path rules normalized to `docs/dev/roadmaps/`
+- `docs/operations/dev/paths.md` roadmap path contract normalized to `docs/dev/roadmaps/`
diff --git a/docs/dev/reports/FINAL_VALIDATION.md b/docs/dev/reports/FINAL_VALIDATION.md
@@ -0,0 +1,21 @@
+# FINAL_VALIDATION
+
+- Timestamp: 2026-04-18T11:09:31
+
+Validation checks:
+- template structure untouched (`git status --short -- games/_template`)
+  - result: PASS
+- start_of_day untouched (`git status --short -- docs/dev/start_of_day`)
+  - result: PASS
+- archived roadmap preserved (`docs/archive/dev-ops/BIG_PICTURE_ROADMAP.md` exists)
+  - result: PASS
+- no broken old-path references in active/runtime-facing docs scope
+  - result: PASS
+  - scope excludes this PR's cleanup reports that intentionally document legacy path mappings
+- docs structure guard (`node tools/dev/checkDocsStructureGuard.mjs`)
+  - result: PASS
+
+Repo cleanliness gate:
+- Working tree contains expected docs-only PR delta files.
+- Scope cleanliness (no feature/runtime code changes): PASS
+- Structural cleanup state: PASS (no removable empty dirs outside excluded scopes; no orphaned `.keep`; no stale target references in active scope).
diff --git a/docs/dev/reports/ROADMAP_RENAME_REFERENCE_UPDATE.md b/docs/dev/reports/ROADMAP_RENAME_REFERENCE_UPDATE.md
@@ -0,0 +1,12 @@
+# ROADMAP_RENAME_REFERENCE_UPDATE
+
+Requested rename:
+- `docs/dev/roadmaps/MASTER_ROADMAP_HIGH_LEVEL.md` -> `docs/dev/roadmaps/MASTER_ROADMAP_ENGINE.md`
+
+Execution result:
+- Source exists before pass: False
+- Destination exists after pass: True
+- Rename action: no-op (source file already absent and destination already authoritative).
+
+- Old-path reference hits after update: 0
+- All detected references now point to `MASTER_ROADMAP_ENGINE.md`.
diff --git a/docs/operations/dev/README.md b/docs/operations/dev/README.md
@@ -9,7 +9,7 @@ The active master roadmap path is:
 - `docs/dev/roadmaps/MASTER_ROADMAP_ENGINE.md`
 
 Do not use superseded roadmap surfaces:
-- `docs/operations/dev/BIG_PICTURE_ROADMAP.md` for the active master roadmap
+- `docs/archive/dev-ops/BIG_PICTURE_ROADMAP.md` for the active master roadmap
 - any other duplicate roadmap location
 
 ### Active Dev Files
diff --git a/docs/operations/dev/ROADMAP_GUARDRAILS.md b/docs/operations/dev/ROADMAP_GUARDRAILS.md
@@ -10,31 +10,31 @@ The active master roadmap file is:
 
 ### Allowed Changes
 - Change ONLY bracket states:
-  - `[ ]` → `[.]` → `[x]`
+  - `[ ]` -> `[.]` -> `[x]`
 
 ### Forbidden Changes
 - Adding/removing sections
 - Rewriting text
 - Reordering items
 - Renaming tracks
 - Collapsing or expanding content
-- Moving the active master roadmap out of `docs/roadmaps/`
+- Moving the active master roadmap out of `docs/dev/roadmaps/`
 - Creating duplicate active roadmap copies elsewhere
 
 ## PATH RULE
 Active roadmap files must live in:
-- `docs/roadmaps/`
+- `docs/dev/roadmaps/`
 
 Never use:
-- `docs/operations/dev/BIG_PICTURE_ROADMAP.md` as the active master roadmap
-- duplicate roadmap copies outside `docs/roadmaps/`
+- `docs/archive/dev-ops/BIG_PICTURE_ROADMAP.md` as the active master roadmap
+- duplicate roadmap copies outside `docs/dev/roadmaps/`
 
 ## Validation Check
 Any change to the active master roadmap must pass:
 - headings unchanged
 - no text modified outside brackets
 - only bracket states updated
-- file path remains under `docs/roadmaps/`
+- file path remains under `docs/dev/roadmaps/`
 
 ## Codex Rule
 Codex must treat the active roadmap as immutable structure and perform surgical edits only.
diff --git a/docs/operations/dev/RULES_OF_ENGAGEMENT.md b/docs/operations/dev/RULES_OF_ENGAGEMENT.md
@@ -23,7 +23,7 @@ This file is the canonical workflow and rules document for active repo operation
 - Planning/docs bundle defines scope and acceptance.
 - Implementation applies approved scope only.
 - Active execution control files are in `docs/dev/`.
-- Update docs/operations/dev/BIG_PICTURE_ROADMAP.md when needed [ ] Todo to [.] inprogress to [x] complete.
+- Update docs/dev/roadmaps/MASTER_ROADMAP_ENGINE.md when needed [ ] Todo to [.] inprogress to [x] complete.
 
 ## Active Dev Controls
 - `docs/operations/dev/codex_commands.md`
diff --git a/docs/operations/dev/paths.md b/docs/operations/dev/paths.md
@@ -1,7 +1,7 @@
 # Repo Path Contracts
 
 ## Active Paths
-- ROADMAP_PATH = `docs/roadmaps/`
+- ROADMAP_PATH = `docs/dev/roadmaps/`
 - MASTER_ROADMAP = `docs/dev/roadmaps/MASTER_ROADMAP_ENGINE.md`
 - PR_PATH = `docs/pr/`
 - REPORTS_PATH = `docs/dev/reports/`
@@ -12,8 +12,8 @@
 - PR_HISTORY_ARCHIVE = `docs/archive/pr/legacy-pr-history/`
 
 ## Strict Rules
-1. Active roadmap files must live in `docs/roadmaps/`.
-2. Do not keep duplicate active roadmap copies outside `docs/roadmaps/`.
-3. Transitional roadmap files outside `docs/roadmaps/` must be archived.
+1. Active roadmap files must live in `docs/dev/roadmaps/`.
+2. Do not keep duplicate active roadmap copies outside `docs/dev/roadmaps/`.
+3. Transitional roadmap files outside `docs/dev/roadmaps/` must be archived.
 4. Reports belong in `docs/dev/reports/`.
 5. PR history belongs in `docs/pr/` or `docs/archive/pr/legacy-pr-history/`.
diff --git a/docs/pr/BUILD_PR_FINAL_REPO_CLEANUP_AND_ROADMAP_RENAME_V3.md b/docs/pr/BUILD_PR_FINAL_REPO_CLEANUP_AND_ROADMAP_RENAME_V3.md
@@ -0,0 +1,56 @@
+# FINAL REPO CLEANUP + ROADMAP RENAME (V3)
+
+## Purpose
+Final safe cleanup with template protection, roadmap rename, and explicit archival of the legacy big-picture roadmap document with pointer updates.
+
+## Scope
+- remove empty directories EXCEPT:
+  - games/_template/
+  - any subfolders under games/_template/
+- remove orphaned `.keep` files where safe
+- clean docs residue
+- rename roadmap file
+- archive:
+  - docs/archive/dev-ops/BIG_PICTURE_ROADMAP.md
+- update all references/pointers that still target the archived big-picture roadmap
+- preserve working-tree integrity
+
+## Hard Guards
+- DO NOT delete:
+  - games/_template/
+  - any directories inside games/_template/, even if empty
+- DO NOT delete any file with unique content unless it is archived with a preserved destination
+- archive must preserve discoverability
+- rename and pointer updates must be atomic with validation
+
+## Required Work
+1. Empty directory cleanup with template exclusion.
+2. Safe `.keep` cleanup outside protected template structure.
+3. Rename:
+   - docs/dev/roadmaps/MASTER_ROADMAP_ENGINE.md
+   -> docs/dev/roadmaps/MASTER_ROADMAP_ENGINE.md
+4. Archive:
+   - docs/archive/dev-ops/BIG_PICTURE_ROADMAP.md
+   into an appropriate archive location under docs/archive/
+5. Update any pointers/references that still target:
+   - docs/archive/dev-ops/BIG_PICTURE_ROADMAP.md
+   so they resolve to the archived location or the authoritative current roadmap location, whichever is correct by context.
+6. Produce validation and mapping reports.
+
+## Required Reports
+- docs/dev/reports/CLEANUP_EMPTY_DIRECTORIES.md
+- docs/dev/reports/CLEANUP_KEEP_FILES.md
+- docs/dev/reports/DOCS_RESIDUE_CLEANUP.md
+- docs/dev/reports/ROADMAP_RENAME_REFERENCE_UPDATE.md
+- docs/dev/reports/BIG_PICTURE_ROADMAP_ARCHIVE_MAP.md
+- docs/dev/reports/FINAL_VALIDATION.md
+
+## Acceptance
+- no empty dirs remain outside protected template structure
+- no unnecessary `.keep` files remain outside protected template structure
+- docs tree is clean and navigable
+- MASTER_ROADMAP_HIGH_LEVEL.md is renamed to MASTER_ROADMAP_ENGINE.md
+- BIG_PICTURE_ROADMAP.md is archived, not lost
+- all affected references are updated
+- zero broken references remain
+- validation report confirms clean repo state
diff --git a/docs/reference/features/docs-system/move-history-preserved.md b/docs/reference/features/docs-system/move-history-preserved.md
@@ -481,7 +481,7 @@ KEEP WHERE IT IS
 - docs/archive/*
 
 MOVE
-- docs/operations/dev/BIG_PICTURE_ROADMAP.md
+- docs/archive/dev-ops/BIG_PICTURE_ROADMAP.md
   -> move to docs/dev/roadmaps/BIG_PICTURE_ROADMAP.md if still needed as an active roadmap
   -> otherwise archive to docs/archive/dev-ops/ if superseded
 
diff --git a/docs/reports/docs_classification_matrix.md b/docs/reports/docs_classification_matrix.md
diff --git a/docs/reports/docs_move_map_proposed.md b/docs/reports/docs_move_map_proposed.md
