Normalize classes_old_keep references to docs-only placeholder

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -2,26 +2,15 @@ MODEL: GPT-5.3-codex
 REASONING: medium
 
 COMMAND:
-Execute BUILD_PR_TARGETED_REPO_CLEANUP_PASS_5_CLASSES_OLD_KEEP_POLICY_PS_FIRST.
+Execute BUILD_PR_TARGETED_REPO_CLEANUP_PASS_6_CLASSES_OLD_KEEP_REFERENCE_NORMALIZATION.
 
-Use the user-supplied PowerShell scan evidence as the primary source of truth:
-- `classes_old_keep` appears only in docs/planning/generated-doc files
-- no `classes_old_keep` directory exists on disk
-- no active runtime/code references were found in the supplied scan output
+- Normalize wording of classes_old_keep references across docs
+- Do not change meaning, only clarify as docs-only placeholder
+- Do not create/delete/move any files or folders
+- Generate:
+  docs/dev/reports/classes_old_keep_normalization_report.md
+  docs/dev/reports/BUILD_PR_TARGETED_REPO_CLEANUP_PASS_6_CLASSES_OLD_KEEP_REFERENCE_NORMALIZATION_report.md
+  docs/dev/reports/validation_checklist.txt
 
-Create exactly:
-- docs/dev/reports/classes_old_keep_policy_inventory.md
-- docs/dev/reports/classes_old_keep_policy_decision.md
-- docs/dev/reports/classes_old_keep_validation_guard.md
-- docs/dev/reports/BUILD_PR_TARGETED_REPO_CLEANUP_PASS_5_CLASSES_OLD_KEEP_POLICY_PS_FIRST_report.md
-- docs/dev/reports/validation_checklist.txt
-
-Constraints:
-- Do NOT rerun broad repo discovery scans already completed by the user unless needed only to validate a specific contradiction.
-- Do NOT create, move, rename, or delete any `classes_old_keep/` directory.
-- Do NOT modify templates/, docs/archive/, or SpriteEditor archive surfaces.
-- Do NOT modify runtime code or repo structure.
-- If roadmap updates are needed, apply bracket-only changes only where exact wording already exists.
-
-Package output to:
-<project folder>/tmp/BUILD_PR_TARGETED_REPO_CLEANUP_PASS_5_CLASSES_OLD_KEEP_POLICY_PS_FIRST.zip
+Package to:
+<project folder>/tmp/BUILD_PR_TARGETED_REPO_CLEANUP_PASS_6_CLASSES_OLD_KEEP_REFERENCE_NORMALIZATION.zip

docs/dev/COMMIT_COMMENT.txt

@@ -1,3 +1 @@
-BUILD_PR_TARGETED_REPO_CLEANUP_PASS_5_CLASSES_OLD_KEEP_POLICY_PS_FIRST
-
-Convert user-supplied PowerShell evidence into docs-only policy, inventory, and validation guard for classes_old_keep.
+Normalize classes_old_keep references to docs-only placeholder

docs/dev/NEXT_COMMAND.txt

@@ -1,2 +1 @@
-After Codex completes and validation passes, proceed to:
-BUILD_PR_TARGETED_REPO_CLEANUP_PASS_6_CLASSES_OLD_KEEP_REFERENCE_NORMALIZATION
+Next: BUILD_PR_TARGETED_REPO_CLEANUP_PASS_7_FINAL_REVIEW

docs/dev/reports/BUILD_PR_REPO_CLEANUP_AND_ROADMAP_UPDATE_report.md

@@ -35,7 +35,7 @@ Per BUILD constraints, wording was left intact and no forced rewrite was perform
 ## Cleanup Inventory Findings Summary
 - `templates/`: exists; live references in active tooling/tests/docs; classification requires manual review in later cleanup lane.
 - `docs/archive/tools/SpriteEditor_old_keep/`: exists; live references in registry/spec/report docs; remains keep-only legacy candidate for later policy PR.
-- `classes_old_keep`: path does not exist; docs-only planning references present.
+- `classes_old_keep (docs-only placeholder, no on-disk path)`: path does not exist; docs-only planning references present.
 - `docs/archive/` archived notes area: exists and actively referenced in documentation structure/policy docs.
 - Legacy import path scan (`/engine/`, `../engine/`, `./engine/` in tools/src/games/samples): no direct matches.
 - Legacy-retirement candidates are present and tracked in roadmap + cleanup planning docs.
@@ -56,3 +56,4 @@ Per BUILD constraints, wording was left intact and no forced rewrite was perform
 - Evidence reports created: PASS
 - No unrelated repo files changed (bundle-scoped): PASS
 
+

docs/dev/reports/BUILD_PR_TARGETED_REPO_CLEANUP_PASS_1_report.md

@@ -16,7 +16,7 @@ Bundle type: execution-ready BUILD docs
 - Formalized enforcement for exactly six approved cleanup targets:
   - `templates/`
   - `docs/archive/tools/SpriteEditor_old_keep/` policy target
-  - `classes_old_keep` policy target
+  - `classes_old_keep (docs-only placeholder, no on-disk path)` policy target
   - `docs/archive/` archived-notes policy target
   - legacy import path patterns
   - eventual legacy-retirement planning target
@@ -79,3 +79,4 @@ Bundle type: execution-ready BUILD docs
    - Result: no entries.
    - Guard result: `RUNTIME_TEST_SURFACE_CHECK: PASS`.
 
+

docs/dev/reports/BUILD_PR_TARGETED_REPO_CLEANUP_PASS_5_CLASSES_OLD_KEEP_POLICY_PS_FIRST_report.md

@@ -13,8 +13,8 @@ Bundle type: execution-ready BUILD docs (classes_old_keep policy, PS-first evide
 - `docs/dev/reports/validation_checklist.txt`
 
 ## User-Supplied Scan Evidence Used (Primary)
-- `classes_old_keep` appears only in docs/planning/generated-doc files.
-- no `classes_old_keep` directory exists on disk.
+- `classes_old_keep (docs-only placeholder, no on-disk path)` appears only in docs/planning/generated-doc files.
+- no `classes_old_keep (docs-only placeholder, no on-disk path)` directory exists on disk.
 - no active runtime/code references found in supplied scan output.
 
 ## Supporting Existing Cleanup Evidence
@@ -41,11 +41,12 @@ Bundle type: execution-ready BUILD docs (classes_old_keep policy, PS-first evide
 - No runtime code or repo-structure changes were made.
 
 ## Validation Results
-1. Verify no `classes_old_keep` directory exists on disk:
+1. Verify no `classes_old_keep (docs-only placeholder, no on-disk path)` directory exists on disk:
    - `Test-Path classes_old_keep` -> `False`
 2. Verify required report files exist:
    - all required files present in `docs/dev/reports/`
 3. Confirm protected start_of_day directories unchanged:
    - `git status --short -- docs/dev/start_of_day/chatGPT docs/dev/start_of_day/codex` -> no entries
 4. Roadmap diff check (if changed):
    - not required; roadmap unchanged in this lane.
+

docs/dev/reports/BUILD_PR_TARGETED_REPO_CLEANUP_PASS_6_CLASSES_OLD_KEEP_REFERENCE_NORMALIZATION_report.md

@@ -0,0 +1,62 @@
+# BUILD_PR_TARGETED_REPO_CLEANUP_PASS_6_CLASSES_OLD_KEEP_REFERENCE_NORMALIZATION Report
+
+Generated: 2026-04-12
+Bundle type: execution-ready BUILD docs (wording normalization)
+
+## Exact Files Created
+- `docs/dev/reports/classes_old_keep_normalization_report.md`
+- `docs/dev/reports/BUILD_PR_TARGETED_REPO_CLEANUP_PASS_6_CLASSES_OLD_KEEP_REFERENCE_NORMALIZATION_report.md`
+
+## Exact Files Changed
+- `docs/dev/reports/archived_notes_policy_decision.md`
+- `docs/dev/reports/archived_notes_validation_guard.md`
+- `docs/dev/reports/BUILD_PR_REPO_CLEANUP_AND_ROADMAP_UPDATE_report.md`
+- `docs/dev/reports/BUILD_PR_TARGETED_REPO_CLEANUP_PASS_1_report.md`
+- `docs/dev/reports/BUILD_PR_TARGETED_REPO_CLEANUP_PASS_5_CLASSES_OLD_KEEP_POLICY_PS_FIRST_report.md`
+- `docs/dev/reports/classes_old_keep_policy_decision.md`
+- `docs/dev/reports/classes_old_keep_policy_inventory.md`
+- `docs/dev/reports/classes_old_keep_validation_guard.md`
+- `docs/dev/reports/cleanup_keep_move_future_delete_matrix.md`
+- `docs/dev/reports/cleanup_live_reference_inventory.txt`
+- `docs/dev/reports/cleanup_target_enforcement_map.md`
+- `docs/dev/reports/cleanup_target_normalization_report.md`
+- `docs/dev/reports/repo_cleanup_targets.txt`
+- `docs/dev/roadmaps/MASTER_ROADMAP_HIGH_LEVEL.md`
+- `docs/pr/BUILD_PR_REPO_CLEANUP_AND_ROADMAP_UPDATE.md`
+- `docs/pr/BUILD_PR_TARGETED_REPO_CLEANUP_PASS_1.md`
+- `docs/pr/BUILD_PR_TARGETED_REPO_CLEANUP_PASS_3_ARCHIVED_NOTES_POLICY.md`
+- `docs/pr/BUILD_PR_TARGETED_REPO_CLEANUP_PASS_5_CLASSES_OLD_KEEP_POLICY_PS_FIRST.md`
+- `docs/pr/BUILD_PR_TARGETED_REPO_CLEANUP_PASS_6_CLASSES_OLD_KEEP_REFERENCE_NORMALIZATION.md`
+- `docs/pr/BUILD_PR_TEMPLATES_POLICY_CLASSIFICATION.md`
+- `docs/dev/reports/validation_checklist.txt`
+
+## Normalization Summary
+- Canonical phrase applied for wording normalization:
+  - `classes_old_keep (docs-only placeholder, no on-disk path)`
+- Normalization was docs-only and meaning-preserving.
+- No cleanup behavior or policy intent was changed.
+
+## Residual References Summary
+- Residual raw token occurrences remain in token-literal contexts (for example command metadata, search token examples, and literal directory check lines).
+- Residual raw-token match count (non-archive docs): 42.
+- Residual details are documented in `classes_old_keep_normalization_report.md`.
+
+## Safety Assertions
+- No file/folder move, rename, or delete executed.
+- No `classes_old_keep/` path was created.
+- `templates/` untouched.
+- `docs/archive/` untouched.
+- SpriteEditor archive surfaces untouched.
+- No runtime code/repo-structure changes.
+
+## Validation Results
+1. Move/Delete/Rename guard:
+   - `git diff --name-status` + filter -> `MOVE_DELETE_RENAME_CHECK: PASS`
+2. Runtime/code surfaces unchanged:
+   - `git diff --name-only -- tools src games samples tests` -> no entries
+3. Protected surfaces unchanged:
+   - `git diff --name-status -- templates docs/archive docs/archive/tools/SpriteEditor_old_keep` -> no entries
+4. Protected start_of_day unchanged:
+   - `git status --short -- docs/dev/start_of_day/chatGPT docs/dev/start_of_day/codex` -> no entries
+5. Canonical phrase presence:
+   - `rg -n "classes_old_keep \(docs-only placeholder, no on-disk path\)" docs --glob "!docs/archive/**"` -> 57 matches

docs/dev/reports/archived_notes_policy_decision.md

@@ -30,7 +30,7 @@ Given this coupling, move/delete/repath actions are unsafe without synchronized
 
 ## Forbidden Now
 - Move, rename, delete, or rewrite any file/path under `docs/archive/` in this lane.
-- Structural cleanup mixed with unrelated targets (`templates`, `SpriteEditor_old_keep`, `classes_old_keep`, legacy import guard work).
+- Structural cleanup mixed with unrelated targets (`templates`, `SpriteEditor_old_keep`, `classes_old_keep (docs-only placeholder, no on-disk path)`, legacy import guard work).
 - Runtime or repo-structure edits under this policy-only BUILD.
 
 ## Exact Prerequisites For Future Migration/Removal Lane
@@ -55,3 +55,4 @@ Policy may move to deletion-oriented consideration only when:
 ## Decision Summary
 - Archived notes remain retained in place for now.
 - This BUILD is policy/guard documentation only and performs no structural repo change.
+

docs/dev/reports/archived_notes_validation_guard.md

@@ -70,7 +70,8 @@ Stop cleanup execution immediately if:
 - `docs/archive/` has move/delete/rename entries without explicit destination and rollback map;
 - protected start_of_day directories show any change;
 - roadmap requires wording rewrite (non bracket-only) to reflect status;
-- cleanup scope expands into unrelated targets (`templates`, `SpriteEditor_old_keep`, `classes_old_keep`, legacy import guard) in the same lane.
+- cleanup scope expands into unrelated targets (`templates`, `SpriteEditor_old_keep`, `classes_old_keep (docs-only placeholder, no on-disk path)`, legacy import guard) in the same lane.
 
 ## Guard Summary
 No future archived-notes structural cleanup should proceed without full reference proof, synchronized docs updates, structural integrity checks, and rollback-ready execution evidence.
+

docs/dev/reports/change_summary.txt

@@ -1,4 +1 @@
-- Uses user-supplied Windows PowerShell scan results instead of spending Codex tokens on broad repo search.
-- Narrows the lane to docs-only policy work for classes_old_keep.
-- Confirms no on-disk classes_old_keep directory exists in the supplied evidence.
-- Keeps templates/, docs/archive/, and SpriteEditor archive surfaces untouched.
+classes_old_keep reference normalization