@@ -5,11 +5,11 @@ ROOT:
 - state_11_1.txt
 
 GENERATED REPORTS (if already consumed):
-- docs/dev/reports/change_summary.txt
+- docs/reports/change_summary.txt
 - docs/dev/reports/expansion_decision.txt
-- docs/dev/reports/file_tree.txt
+- docs/reports/file_tree.txt
 - docs/dev/reports/readiness_decision.txt
-- docs/dev/reports/validation_checklist.txt
+- docs/reports/validation_checklist.txt
 
 DUPLICATE / CONSOLIDATE CANDIDATES:
 - docs/dev/---patches-fixes.txt
 
@@ -29,11 +29,11 @@ These are not part of the long-term docs system and can be removed from the repo
 
 ### Generated report artifacts
 These are useful during review, but should not accumulate indefinitely if their conclusions are already captured elsewhere:
-- `docs/dev/reports/change_summary.txt`
+- `docs/reports/change_summary.txt`
 - `docs/dev/reports/expansion_decision.txt`
-- `docs/dev/reports/file_tree.txt`
+- `docs/reports/file_tree.txt`
 - `docs/dev/reports/readiness_decision.txt`
-- `docs/dev/reports/validation_checklist.txt`
+- `docs/reports/validation_checklist.txt`
 
 Recommended rule:
 - keep only the latest report set for the currently active PR, or
@@ -76,7 +76,7 @@ Why keep them:
 ### Keep in `docs/dev/`
 These should remain as the active operating files:
 - `docs/dev/WORKFLOW_RULES.md`
-- `docs/dev/README.md`
+- `docs/operations/dev/README.md`
 - `docs/dev/CODEX_COMMANDS.md` (active PR only)
 - `docs/dev/COMMIT_COMMENT.txt` (active PR only)
 - `docs/dev/NEXT_COMMAND.txt` (active PR only)
@@ -94,52 +94,52 @@ Update to reflect:
 - current recommended path is template-based new project startup
 - docs-first / Codex-build workflow
 
-### 2. `docs/README.md`
+### 2. `docs/reference/root/README.md`
 Update to explain:
 - `docs/pr/` = architectural and PR history
 - `docs/dev/` = active workflow and temporary execution controls
 - `docs/dev/reports/` = generated review artifacts
 - `docs/architecture/` = engine boundary / architecture references
 
-### 3. `docs/repo-directory-structure.md`
+### 3. `docs/reference/root/repo-directory-structure.md`
 This needs explicit updates for:
 - `src/advanced/state/`
 - `docs/dev/reports/`
 - current purpose of `games/`, `tools/`, `samples/`
 - distinction between `src/engine/` and `src/advanced/`
 
-### 4. `docs/getting-started.md`
+### 4. `docs/reference/root/getting-started.md`
 Update onboarding to current reality:
 - use docs-first workflow
 - PLAN_PR → BUILD_PR → APPLY_PR
 - Codex writes code
 - reports now live under `docs/dev/reports/`
 - new projects should start from the template snapshot pattern
 
-### 5. `docs/review-checklist.md`
+### 5. `docs/reference/root/review-checklist.md`
 Update review checklist to include:
 - check for `docs/dev/reports/`
 - verify no engine-boundary violations
 - verify new advanced work lives in `src/advanced/`
 - verify PR docs are in `docs/pr/`
 - verify ZIP output path uses `<project folder>/tmp/...`
 
-### 6. `docs/architecture/README.md`
+### 6. `docs/reference/architecture-standards/architecture/README.md`
 Update to include the current layered model:
 - `src/engine/` = stable foundational systems
 - `src/advanced/` = composable optional architecture layer
 - `games/` = primary consumers
 - `tools/` = optional consumers
 - `samples/` = demonstration only
 
-### 7. `docs/architecture/engine-api-boundary.md`
+### 7. `docs/reference/architecture-standards/architecture/engine-api-boundary.md`
 Update to explicitly state:
 - authoritative state belongs in `src/advanced/state/`, not `src/engine/state/`
 - engine must not import advanced systems
 - reusable + foundational goes to `src/engine/`
 - reusable + composable goes to `src/advanced/`
 
-### 8. `docs/dev/README.md`
+### 8. `docs/operations/dev/README.md`
 Update to current operating model:
 - docs-only bundles from planning
 - Codex performs implementation
@@ -152,7 +152,7 @@ Update to current operating model:
 
 ### Canonical files to keep active
 - `docs/dev/WORKFLOW_RULES.md`
-- `docs/dev/README.md`
+- `docs/operations/dev/README.md`
 - `docs/dev/CODEX_COMMANDS.md`
 - `docs/dev/COMMIT_COMMENT.txt`
 - `docs/dev/NEXT_COMMAND.txt`
@@ -188,13 +188,13 @@ If you want the cleanest current-state repo:
 
 ### Update now
 - `README.md`
-- `docs/README.md`
-- `docs/repo-directory-structure.md`
-- `docs/getting-started.md`
-- `docs/review-checklist.md`
-- `docs/architecture/README.md`
-- `docs/architecture/engine-api-boundary.md`
-- `docs/dev/README.md`
+- `docs/reference/root/README.md`
+- `docs/reference/root/repo-directory-structure.md`
+- `docs/reference/root/getting-started.md`
+- `docs/reference/root/review-checklist.md`
+- `docs/reference/architecture-standards/architecture/README.md`
+- `docs/reference/architecture-standards/architecture/engine-api-boundary.md`
+- `docs/operations/dev/README.md`
 
 ### Keep
 - `docs/pr/` history
 
@@ -1,13 +1,13 @@
 UPDATE TO CURRENT STATE
 
 - README.md
-- docs/README.md
-- docs/repo-directory-structure.md
-- docs/getting-started.md
-- docs/review-checklist.md
-- docs/architecture/README.md
-- docs/architecture/engine-api-boundary.md
-- docs/dev/README.md
+- docs/reference/root/README.md
+- docs/reference/root/repo-directory-structure.md
+- docs/reference/root/getting-started.md
+- docs/reference/root/review-checklist.md
+- docs/reference/architecture-standards/architecture/README.md
+- docs/reference/architecture-standards/architecture/engine-api-boundary.md
+- docs/operations/dev/README.md
 
 CURRENT-STATE ITEMS TO REFLECT
 - src/advanced/state/ exists
 
@@ -6,7 +6,7 @@ Checks:
 - found tools/shared/projectManifestContract.js
 - found tools/shared/projectSystem.js
 - found tools/shared/projectSystemAdapters.js
-- found docs/specs/project_manifest_contract.md
+- found docs/reference/architecture-standards/specs/project_manifest_contract.md
 - active tools match expected first-class list (7)
 - Sprite Editor remains first-class and visible
 - SpriteEditor_old_keep remains hidden legacy
 
@@ -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/dev/BIG_PICTURE_ROADMAP.md` and associated docs/dev control/report updates.
+Apply the approved encoding-only fix for `docs/operations/dev/BIG_PICTURE_ROADMAP.md` and associated docs/dev control/report updates.
 
 ## Apply Requirements
 1. Keep roadmap content unchanged.
 
@@ -38,7 +38,7 @@ Included contracts:
 - No regressions outside inspector scope
 
 ## Roadmap Update
-Update only bracket states in docs/dev/BIG_PICTURE_ROADMAP.md
+Update only bracket states in docs/operations/dev/BIG_PICTURE_ROADMAP.md
 
 Track I:
 - Entity inspector -> [x]
 
@@ -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/dev/BIG_PICTURE_ROADMAP.md`:
+In `docs/operations/dev/BIG_PICTURE_ROADMAP.md`:
 - Connection status panel -> `[x]`
 - Latency / RTT panel -> `[x]`
 - Event tracing -> `[x]`
 
@@ -13,10 +13,10 @@ 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/dev/BIG_PICTURE_ROADMAP.md`
-- `docs/dev/codex_commands.md`
-- `docs/dev/commit_comment.txt`
-- `docs/dev/next_command.txt`
+- `docs/operations/dev/BIG_PICTURE_ROADMAP.md`
+- `docs/operations/dev/codex_commands.md`
+- `docs/operations/dev/commit_comment.txt`
+- `docs/operations/dev/next_command.txt`
 - `docs/dev/reports/*`
 
 ## Validation
 
@@ -35,9 +35,9 @@ Provide the execution checklist for implementing the overlay panel registry cont
 - validate `node --check` or equivalent on touched JS files
 
 ### Docs / Reporting
-- update `docs/dev/reports/change_summary.txt`
-- update `docs/dev/reports/validation_checklist.txt`
-- update `docs/dev/reports/file_tree.txt`
+- update `docs/reports/change_summary.txt`
+- update `docs/reports/validation_checklist.txt`
+- update `docs/reports/file_tree.txt`
 - keep all BUILD/APPLY notes scoped to this PR purpose only
 
 ## Commit Comment Guidance
 
@@ -169,8 +169,8 @@ Likely targets:
 - `tools/shared/` vector-compatible contract helpers only if required by existing runtime path
 - `tests/tools/` and/or `tests/src/src/engine/` new contract tests
 - `docs/pr/APPLY_PR_RENDER_PIPELINE_CONTRACT_ALL_4_TOOLS.md`
-- `docs/dev/change_summary.txt`
-- `docs/dev/validation_checklist.txt`
+- `docs/operations/dev/change_summary.txt`
+- `docs/operations/dev/validation_checklist.txt`
 
 ## Acceptance Criteria
 - All four tool document types load through one approved contract path