Skip to content

Commit b507a96

Browse files
author
DavidQ
committed
Execute docs move-map for Track F
- applied classification move-map - organized docs into buckets - preserved all content Roadmap: Track F progress maintained
1 parent dbf38a1 commit b507a96

622 files changed

Lines changed: 1933 additions & 1966 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

docs/archive/dev-ops/DELETE_CANDIDATES.txt

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,11 +5,11 @@ ROOT:
55
- state_11_1.txt
66

77
GENERATED REPORTS (if already consumed):
8-
- docs/dev/reports/change_summary.txt
8+
- docs/reports/change_summary.txt
99
- docs/dev/reports/expansion_decision.txt
10-
- docs/dev/reports/file_tree.txt
10+
- docs/reports/file_tree.txt
1111
- docs/dev/reports/readiness_decision.txt
12-
- docs/dev/reports/validation_checklist.txt
12+
- docs/reports/validation_checklist.txt
1313

1414
DUPLICATE / CONSOLIDATE CANDIDATES:
1515
- docs/dev/---patches-fixes.txt

docs/archive/dev-ops/DOC_CLEANUP_AND_UPDATE_AUDIT.md

Lines changed: 19 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -29,11 +29,11 @@ These are not part of the long-term docs system and can be removed from the repo
2929

3030
### Generated report artifacts
3131
These are useful during review, but should not accumulate indefinitely if their conclusions are already captured elsewhere:
32-
- `docs/dev/reports/change_summary.txt`
32+
- `docs/reports/change_summary.txt`
3333
- `docs/dev/reports/expansion_decision.txt`
34-
- `docs/dev/reports/file_tree.txt`
34+
- `docs/reports/file_tree.txt`
3535
- `docs/dev/reports/readiness_decision.txt`
36-
- `docs/dev/reports/validation_checklist.txt`
36+
- `docs/reports/validation_checklist.txt`
3737

3838
Recommended rule:
3939
- keep only the latest report set for the currently active PR, or
@@ -76,7 +76,7 @@ Why keep them:
7676
### Keep in `docs/dev/`
7777
These should remain as the active operating files:
7878
- `docs/dev/WORKFLOW_RULES.md`
79-
- `docs/dev/README.md`
79+
- `docs/operations/dev/README.md`
8080
- `docs/dev/CODEX_COMMANDS.md` (active PR only)
8181
- `docs/dev/COMMIT_COMMENT.txt` (active PR only)
8282
- `docs/dev/NEXT_COMMAND.txt` (active PR only)
@@ -94,52 +94,52 @@ Update to reflect:
9494
- current recommended path is template-based new project startup
9595
- docs-first / Codex-build workflow
9696

97-
### 2. `docs/README.md`
97+
### 2. `docs/reference/root/README.md`
9898
Update to explain:
9999
- `docs/pr/` = architectural and PR history
100100
- `docs/dev/` = active workflow and temporary execution controls
101101
- `docs/dev/reports/` = generated review artifacts
102102
- `docs/architecture/` = engine boundary / architecture references
103103

104-
### 3. `docs/repo-directory-structure.md`
104+
### 3. `docs/reference/root/repo-directory-structure.md`
105105
This needs explicit updates for:
106106
- `src/advanced/state/`
107107
- `docs/dev/reports/`
108108
- current purpose of `games/`, `tools/`, `samples/`
109109
- distinction between `src/engine/` and `src/advanced/`
110110

111-
### 4. `docs/getting-started.md`
111+
### 4. `docs/reference/root/getting-started.md`
112112
Update onboarding to current reality:
113113
- use docs-first workflow
114114
- PLAN_PR → BUILD_PR → APPLY_PR
115115
- Codex writes code
116116
- reports now live under `docs/dev/reports/`
117117
- new projects should start from the template snapshot pattern
118118

119-
### 5. `docs/review-checklist.md`
119+
### 5. `docs/reference/root/review-checklist.md`
120120
Update review checklist to include:
121121
- check for `docs/dev/reports/`
122122
- verify no engine-boundary violations
123123
- verify new advanced work lives in `src/advanced/`
124124
- verify PR docs are in `docs/pr/`
125125
- verify ZIP output path uses `<project folder>/tmp/...`
126126

127-
### 6. `docs/architecture/README.md`
127+
### 6. `docs/reference/architecture-standards/architecture/README.md`
128128
Update to include the current layered model:
129129
- `src/engine/` = stable foundational systems
130130
- `src/advanced/` = composable optional architecture layer
131131
- `games/` = primary consumers
132132
- `tools/` = optional consumers
133133
- `samples/` = demonstration only
134134

135-
### 7. `docs/architecture/engine-api-boundary.md`
135+
### 7. `docs/reference/architecture-standards/architecture/engine-api-boundary.md`
136136
Update to explicitly state:
137137
- authoritative state belongs in `src/advanced/state/`, not `src/engine/state/`
138138
- engine must not import advanced systems
139139
- reusable + foundational goes to `src/engine/`
140140
- reusable + composable goes to `src/advanced/`
141141

142-
### 8. `docs/dev/README.md`
142+
### 8. `docs/operations/dev/README.md`
143143
Update to current operating model:
144144
- docs-only bundles from planning
145145
- Codex performs implementation
@@ -152,7 +152,7 @@ Update to current operating model:
152152

153153
### Canonical files to keep active
154154
- `docs/dev/WORKFLOW_RULES.md`
155-
- `docs/dev/README.md`
155+
- `docs/operations/dev/README.md`
156156
- `docs/dev/CODEX_COMMANDS.md`
157157
- `docs/dev/COMMIT_COMMENT.txt`
158158
- `docs/dev/NEXT_COMMAND.txt`
@@ -188,13 +188,13 @@ If you want the cleanest current-state repo:
188188

189189
### Update now
190190
- `README.md`
191-
- `docs/README.md`
192-
- `docs/repo-directory-structure.md`
193-
- `docs/getting-started.md`
194-
- `docs/review-checklist.md`
195-
- `docs/architecture/README.md`
196-
- `docs/architecture/engine-api-boundary.md`
197-
- `docs/dev/README.md`
191+
- `docs/reference/root/README.md`
192+
- `docs/reference/root/repo-directory-structure.md`
193+
- `docs/reference/root/getting-started.md`
194+
- `docs/reference/root/review-checklist.md`
195+
- `docs/reference/architecture-standards/architecture/README.md`
196+
- `docs/reference/architecture-standards/architecture/engine-api-boundary.md`
197+
- `docs/operations/dev/README.md`
198198

199199
### Keep
200200
- `docs/pr/` history

docs/archive/dev-ops/UPDATE_REQUIRED.txt

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
UPDATE TO CURRENT STATE
22

33
- README.md
4-
- docs/README.md
5-
- docs/repo-directory-structure.md
6-
- docs/getting-started.md
7-
- docs/review-checklist.md
8-
- docs/architecture/README.md
9-
- docs/architecture/engine-api-boundary.md
10-
- docs/dev/README.md
4+
- docs/reference/root/README.md
5+
- docs/reference/root/repo-directory-structure.md
6+
- docs/reference/root/getting-started.md
7+
- docs/reference/root/review-checklist.md
8+
- docs/reference/architecture-standards/architecture/README.md
9+
- docs/reference/architecture-standards/architecture/engine-api-boundary.md
10+
- docs/operations/dev/README.md
1111

1212
CURRENT-STATE ITEMS TO REFLECT
1313
- src/advanced/state/ exists

docs/archive/generated-reports/dev-reports/project_system_validation.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ Checks:
66
- found tools/shared/projectManifestContract.js
77
- found tools/shared/projectSystem.js
88
- found tools/shared/projectSystemAdapters.js
9-
- found docs/specs/project_manifest_contract.md
9+
- found docs/reference/architecture-standards/specs/project_manifest_contract.md
1010
- active tools match expected first-class list (7)
1111
- Sprite Editor remains first-class and visible
1212
- SpriteEditor_old_keep remains hidden legacy

docs/archive/pr/legacy-pr-history/APPLY_PR_BIG_PICTURE_ROADMAP_ENCODING_FIX.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ APPLY_PR_BIG_PICTURE_ROADMAP_ENCODING_FIX.md
66
# APPLY_PR_BIG_PICTURE_ROADMAP_ENCODING_FIX
77

88
## Apply Scope
9-
Apply the approved encoding-only fix for `docs/dev/BIG_PICTURE_ROADMAP.md` and associated docs/dev control/report updates.
9+
Apply the approved encoding-only fix for `docs/operations/dev/BIG_PICTURE_ROADMAP.md` and associated docs/dev control/report updates.
1010

1111
## Apply Requirements
1212
1. Keep roadmap content unchanged.

docs/archive/pr/legacy-pr-history/APPLY_PR_DEBUG_SURFACES_INSPECTORS.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ Included contracts:
3838
- No regressions outside inspector scope
3939

4040
## Roadmap Update
41-
Update only bracket states in docs/dev/BIG_PICTURE_ROADMAP.md
41+
Update only bracket states in docs/operations/dev/BIG_PICTURE_ROADMAP.md
4242

4343
Track I:
4444
- Entity inspector -> [x]

docs/archive/pr/legacy-pr-history/APPLY_PR_DEBUG_SURFACES_NETWORK_SAMPLE_A.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ Apply the approved Sample A implementation only:
1313
- update docs/dev controls and reports for this PR
1414

1515
## Roadmap Updates (Bracket-Only)
16-
In `docs/dev/BIG_PICTURE_ROADMAP.md`:
16+
In `docs/operations/dev/BIG_PICTURE_ROADMAP.md`:
1717
- Connection status panel -> `[x]`
1818
- Latency / RTT panel -> `[x]`
1919
- Event tracing -> `[x]`

docs/archive/pr/legacy-pr-history/APPLY_PR_DEBUG_SURFACES_NETWORK_SAMPLE_C_FULL.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -13,10 +13,10 @@ Apply the docs-first Sample C planning slice and use it as the Codex-ready instr
1313
- `docs/pr/BUILD_PR_DEBUG_SURFACES_NETWORK_SAMPLE_C_FULL.md`
1414
- `docs/pr/APPLY_PR_DEBUG_SURFACES_NETWORK_SAMPLE_C_FULL.md`
1515
- `docs/dev/NETWORK_SAMPLES_PLAN.md`
16-
- `docs/dev/BIG_PICTURE_ROADMAP.md`
17-
- `docs/dev/codex_commands.md`
18-
- `docs/dev/commit_comment.txt`
19-
- `docs/dev/next_command.txt`
16+
- `docs/operations/dev/BIG_PICTURE_ROADMAP.md`
17+
- `docs/operations/dev/codex_commands.md`
18+
- `docs/operations/dev/commit_comment.txt`
19+
- `docs/operations/dev/next_command.txt`
2020
- `docs/dev/reports/*`
2121

2222
## Validation

docs/archive/pr/legacy-pr-history/APPLY_PR_OVERLAY_PANEL_REGISTRY.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -35,9 +35,9 @@ Provide the execution checklist for implementing the overlay panel registry cont
3535
- validate `node --check` or equivalent on touched JS files
3636

3737
### Docs / Reporting
38-
- update `docs/dev/reports/change_summary.txt`
39-
- update `docs/dev/reports/validation_checklist.txt`
40-
- update `docs/dev/reports/file_tree.txt`
38+
- update `docs/reports/change_summary.txt`
39+
- update `docs/reports/validation_checklist.txt`
40+
- update `docs/reports/file_tree.txt`
4141
- keep all BUILD/APPLY notes scoped to this PR purpose only
4242

4343
## Commit Comment Guidance

docs/archive/pr/legacy-pr-history/APPLY_PR_RENDER_PIPELINE_CONTRACT_ALL_4_TOOLS.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -169,8 +169,8 @@ Likely targets:
169169
- `tools/shared/` vector-compatible contract helpers only if required by existing runtime path
170170
- `tests/tools/` and/or `tests/src/src/engine/` new contract tests
171171
- `docs/pr/APPLY_PR_RENDER_PIPELINE_CONTRACT_ALL_4_TOOLS.md`
172-
- `docs/dev/change_summary.txt`
173-
- `docs/dev/validation_checklist.txt`
172+
- `docs/operations/dev/change_summary.txt`
173+
- `docs/operations/dev/validation_checklist.txt`
174174

175175
## Acceptance Criteria
176176
- All four tool document types load through one approved contract path

0 commit comments

Comments
 (0)