Promote tool roadmap rules out of checklist tracking

DavidQ · DavidQ · commit b556d53af254 · 2026-04-14T22:18:53.000-04:00
BUILD_PR_ROADMAP_TOOL_RULES_PROMOTION_AND_CLEANUP
diff --git a/docs/MASTER_ROADMAP_HIGH_LEVEL.md b/docs/MASTER_ROADMAP_HIGH_LEVEL.md
@@ -54,6 +54,10 @@
 - legacy tools remain isolated and visibly non-current
 - 3D tools arrive when 3D capability needs them, not before
 - content pipeline tools arrive when asset complexity justifies them
+- no standalone showcase-only tool tracks
+- tools header accordion added to reduce vertical real-estate usage
+- tool-shell UI compaction is useful but does not replace tool-boundary normalization work
+- any follow-up tool UI cleanup should remain subordinate to shared-boundary and data-contract work
 
 ### End State Vision
 - clean engine core
@@ -466,12 +470,6 @@
 - [ ] 3D prerequisite samples before advanced 3D tools
 - [.] content pipeline tools after asset complexity justifies them
 - [.] debug tools align with engine/debug maturity
-- [ ] no standalone showcase-only tool tracks
-
-### Recent Tool Shell Notes
-- [.] tools header accordion added to reduce vertical real-estate usage
-- [.] tool-shell UI compaction is useful but does not replace tool-boundary normalization work
-- [ ] any follow-up tool UI cleanup should remain subordinate to shared-boundary and data-contract work
 
 ---
 
diff --git a/docs/dev/CODEX_COMMANDS.md b/docs/dev/CODEX_COMMANDS.md
@@ -2,25 +2,32 @@ MODEL: GPT-5.4
 REASONING: high
 
 COMMAND:
-Create `BUILD_PR_LEVEL_16_PHASE_DESCRIPTIONS_REPO_WIDE_NORMALIZATION`.
+Create `BUILD_PR_ROADMAP_TOOL_RULES_PROMOTION_AND_CLEANUP`.
 
-Goal:
-Close the final remaining item:
-- phase descriptions normalized repo-wide
+1. Locate these roadmap items:
+- no standalone showcase-only tool tracks
+- tools header accordion added to reduce vertical real-estate usage
+- tool-shell UI compaction is useful but does not replace tool-boundary normalization work
+- any follow-up tool UI cleanup should remain subordinate to shared-boundary and data-contract work
 
-Required work:
-1. Find repo locations where phase descriptions are defined or repeated.
-2. Normalize them so they are consistent with the current roadmap, numbering, and phase structure.
-3. Touch only phase-description text and directly related references.
-4. Do not expand scope into unrelated documentation cleanup.
-5. Update roadmap status markers only.
-6. Report whether the item can now be truthfully marked complete.
+2. Reclassify them as rules/instructions:
+- move them to the top roadmap rules/instructions area
+- remove checklist/status markers
+- preserve wording exactly
 
-Final packaging step is REQUIRED:
+3. Do NOT:
+- delete content
+- rewrite wording
+- alter unrelated roadmap text
+
+4. Ensure the checklist/task area only contains actionable work after the move.
+
+5. Final packaging step is REQUIRED:
 - package ALL changed files into this exact repo-structured ZIP:
-  `<project folder>/tmp/BUILD_PR_LEVEL_16_PHASE_DESCRIPTIONS_REPO_WIDE_NORMALIZATION.zip`
+  `<project folder>/tmp/BUILD_PR_ROADMAP_TOOL_RULES_PROMOTION_AND_CLEANUP.zip`
 
 Hard rules:
-- smallest valid closeout
+- move, do not delete
+- no wording changes
 - no unrelated repo changes
 - no missing ZIP
diff --git a/docs/dev/COMMIT_COMMENT.txt b/docs/dev/COMMIT_COMMENT.txt
@@ -1,2 +1,2 @@
-Normalize phase descriptions repo-wide and close the final Section-16 residue
-BUILD_PR_LEVEL_16_PHASE_DESCRIPTIONS_REPO_WIDE_NORMALIZATION
+Promote tool roadmap rules out of checklist tracking
+BUILD_PR_ROADMAP_TOOL_RULES_PROMOTION_AND_CLEANUP
diff --git a/docs/dev/reports/change_summary.txt b/docs/dev/reports/change_summary.txt
@@ -1,2 +1,3 @@
-- Added final residue-only PR for repo-wide phase-description normalization
-- Intended to close the last remaining item in Sections 15/16
+- Added roadmap cleanup PR for tool-governance rules
+- Moves tool-governance items from checklist/status tracking to top-level roadmap instructions
+- Preserves wording and avoids deletion
diff --git a/docs/dev/reports/validation_checklist.txt b/docs/dev/reports/validation_checklist.txt
@@ -1,6 +1,6 @@
-- phase-description text normalized repo-wide where needed
-- unrelated docs left untouched
-- roadmap updated by status markers only
-- final item can be truthfully marked complete or exact blockers are reported
+- all specified tool-governance items moved to top-level rules/instructions area
+- wording preserved exactly
+- checklist/status markers removed from those items
+- roadmap task areas left with actionable work only
 - output ZIP created at:
-  <project folder>/tmp/BUILD_PR_LEVEL_16_PHASE_DESCRIPTIONS_REPO_WIDE_NORMALIZATION.zip
+  <project folder>/tmp/BUILD_PR_ROADMAP_TOOL_RULES_PROMOTION_AND_CLEANUP.zip
diff --git a/docs/dev/roadmaps/MASTER_ROADMAP_HIGH_LEVEL.md b/docs/dev/roadmaps/MASTER_ROADMAP_HIGH_LEVEL.md
@@ -65,6 +65,10 @@
 - legacy tools remain isolated and visibly non-current
 - 3D tools arrive when 3D capability needs them, not before
 - content pipeline tools arrive when asset complexity justifies them
+- no standalone showcase-only tool tracks
+- tools header accordion added to reduce vertical real-estate usage
+- tool-shell UI compaction is useful but does not replace tool-boundary normalization work
+- any follow-up tool UI cleanup should remain subordinate to shared-boundary and data-contract work
 
 ### End State Vision
 - clean engine core
@@ -457,12 +461,6 @@
 - [ ] 3D prerequisite samples before advanced 3D tools
 - [x] content pipeline tools after asset complexity justifies them
 - [x] debug tools align with engine/debug maturity
-- [ ] no standalone showcase-only tool tracks
-
-### Recent Tool Shell Notes
-- [.] tools header accordion added to reduce vertical real-estate usage
-- [.] tool-shell UI compaction is useful but does not replace tool-boundary normalization work
-- [ ] any follow-up tool UI cleanup should remain subordinate to shared-boundary and data-contract work
 
 ---
 
diff --git a/docs/pr/BUILD_PR_ROADMAP_TOOL_RULES_PROMOTION_AND_CLEANUP.md b/docs/pr/BUILD_PR_ROADMAP_TOOL_RULES_PROMOTION_AND_CLEANUP.md
@@ -0,0 +1,44 @@
+# BUILD_PR_ROADMAP_TOOL_RULES_PROMOTION_AND_CLEANUP
+
+## Purpose
+Promote tool-governance rules out of checklist/status tracking and normalize them as top-level roadmap instructions.
+
+## Items to reclassify
+
+These should be treated as rules/instructions, not tasks:
+
+- no standalone showcase-only tool tracks
+- tools header accordion added to reduce vertical real-estate usage
+- tool-shell UI compaction is useful but does not replace tool-boundary normalization work
+- any follow-up tool UI cleanup should remain subordinate to shared-boundary and data-contract work
+
+## Required change
+
+### A. Promote to top-level instruction/rules area
+Move the above items to the top roadmap rules/instructions area.
+
+### B. Remove checklist/status semantics
+- remove `[ ]` / `[.]` markers from these items
+- keep wording unchanged
+- preserve content by move, not delete
+
+### C. Keep roadmap task lists actionable
+After this PR:
+- checklist items should represent real work to complete
+- rules/governance items should live in top-level rules/instructions, not as status-tracked tasks
+
+## Constraints
+- no wording changes
+- no deletion
+- move only, plus checkbox/status removal as part of the move
+- roadmap text otherwise untouched
+- status-only updates elsewhere if needed
+
+## Validation
+Codex must report:
+- where each item was moved
+- confirmation that wording was preserved
+- confirmation that the checklist no longer tracks these as tasks
+
+## Packaging
+`<project folder>/tmp/BUILD_PR_ROADMAP_TOOL_RULES_PROMOTION_AND_CLEANUP.zip`
