Skip to content

Commit dbf38a1

Browse files
author
DavidQ
committed
Start Track F docs system classification foundation
- inventory docs tree - classify docs into explicit buckets - define bucket ownership rules - propose move map for later cleanup PRs - preserve historical docs in this lane - update roadmap status only where execution-backed PR Details - advances 18 / Track F from [ ] to [.] - advances 'classify all docs into buckets' from [ ] to [x] when validation passes
1 parent c9bef25 commit dbf38a1

11 files changed

Lines changed: 5070 additions & 21 deletions

‎docs/dev/CODEX_COMMANDS.md‎

Lines changed: 33 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,34 @@
1-
MODEL: GPT-5.3-codex
2-
REASONING: medium
1+
MODEL: GPT-5.4
2+
REASONING: high
3+
34
COMMAND:
4-
Validate CSS/UI normalization completion:
5-
- confirm no duplicate CSS rules
6-
- confirm shared UI class usage
7-
- confirm flattened CSS layers
8-
Update roadmap Track E:
9-
[.] → [x]
5+
Create `BUILD_PR_LEVEL_18_15_TRACK_F_DOCS_SYSTEM_CLASSIFICATION_FOUNDATION` as a docs-first, one-purpose PR for Track F foundation only.
6+
7+
Required work:
8+
1. Scan the repo `docs/` tree only.
9+
2. Produce:
10+
- `docs/dev/reports/docs_inventory_tree.txt`
11+
- `docs/dev/reports/docs_classification_matrix.md`
12+
- `docs/dev/reports/docs_bucket_rules.md`
13+
- `docs/dev/reports/docs_move_map_proposed.md`
14+
- `docs/dev/reports/BUILD_PR_LEVEL_18_15_TRACK_F_DOCS_SYSTEM_CLASSIFICATION_FOUNDATION_VALIDATION.md`
15+
3. Classify all docs into explicit buckets.
16+
4. Define non-overlapping bucket rules.
17+
5. Propose move targets for later cleanup PRs without deleting historical docs.
18+
6. Update roadmap status only if execution is complete:
19+
- `18. Track F – Docs System Cleanup` `[ ] -> [.]`
20+
- `classify all docs into buckets` `[ ] -> [x]`
21+
7. Preserve all unrelated working-tree changes.
22+
23+
Hard guards:
24+
- no implementation code
25+
- no non-doc changes
26+
- no doc deletion in this PR
27+
- no roadmap rewrites
28+
- no status jumps other than `[ ] -> [.]` or `[.] -> [x]`
29+
- do not modify `start_of_day`
30+
- keep scope strictly to Track F foundation
31+
32+
Artifact:
33+
- package the repo-structured ZIP to:
34+
`<project folder>/tmp/BUILD_PR_LEVEL_18_15_TRACK_F_DOCS_SYSTEM_CLASSIFICATION_FOUNDATION.zip`

‎docs/dev/COMMIT_COMMENT.txt‎

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,12 @@
1-
Complete Track E CSS/UI normalization
1+
Start Track F docs system classification foundation
22

3-
- flattened CSS layers
4-
- enforced shared UI classes
5-
- removed redundant styles
3+
- inventory docs tree
4+
- classify docs into explicit buckets
5+
- define bucket ownership rules
6+
- propose move map for later cleanup PRs
7+
- preserve historical docs in this lane
8+
- update roadmap status only where execution-backed
69

7-
Roadmap:
8-
18 Track E [.] → [x]
10+
PR Details
11+
- advances 18 / Track F from [ ] to [.]
12+
- advances 'classify all docs into buckets' from [ ] to [x] when validation passes

‎docs/dev/reports/BUILD_PR_LEVEL_18_15_TRACK_F_DOCS_SYSTEM_CLASSIFICATION_FOUNDATION_VALIDATION.md‎

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
# BUILD_PR_LEVEL_18_15_TRACK_F_DOCS_SYSTEM_CLASSIFICATION_FOUNDATION_VALIDATION
2+
3+
## Execution Summary
4+
- Scope scanned: `docs/` tree only
5+
- Total docs files classified: **1584**
6+
- Bucket count: **11**
7+
- Unclassified files: **0**
8+
9+
## Required Artifacts
10+
- generated: `docs/dev/reports/docs_inventory_tree.txt`
11+
- generated: `docs/dev/reports/docs_classification_matrix.md`
12+
- generated: `docs/dev/reports/docs_bucket_rules.md`
13+
- generated: `docs/dev/reports/docs_move_map_proposed.md`
14+
- generated: `docs/dev/reports/BUILD_PR_LEVEL_18_15_TRACK_F_DOCS_SYSTEM_CLASSIFICATION_FOUNDATION_VALIDATION.md`
15+
16+
## Guard Compliance
17+
- no implementation code changes
18+
- no non-doc changes
19+
- no doc deletion performed
20+
- no `start_of_day` modifications
21+
- roadmap updated via status-only transitions only
22+
23+
## Roadmap Status Transitions Applied
24+
- `Track F ? Docs System Cleanup` marker: `[ ] -> [.]` (applied on docs organization line)
25+
- `classify all docs into buckets`: `[ ] -> [x]`
26+
27+
## Notes
28+
- Move targets are proposals for later cleanup PRs only.
29+
- Historical docs remain intact in this PR.

‎docs/dev/reports/change_summary.txt‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,2 @@
1-
Track E completed and marked [x] based on validation-backed normalization.
1+
This bundle starts the Docs System Cleanup lane using the smallest executable foundation pass.
2+
It limits scope to docs classification, bucket rules, a proposed move map, and execution-backed roadmap status progression only.

‎docs/dev/reports/docs_bucket_rules.md‎

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
# Docs Bucket Rules
2+
3+
These rules are strict, precedence-ordered, and non-overlapping by first-match assignment.
4+
5+
## Rule Order (Highest Precedence First)
6+
7+
1. `START_OF_DAY_PROTECTED`
8+
Basis: Protected start_of_day operational context and instructions.
9+
2. `ROADMAPS`
10+
Basis: Master and auxiliary roadmap trackers.
11+
3. `EXECUTION_REPORTS`
12+
Basis: Execution/validation/change reports and run outputs.
13+
4. `PR_BUILD_TRACKING`
14+
Basis: PLAN/BUILD/APPLY definitions, templates, and PR tracking artifacts.
15+
5. `RELEASE_ADOPTION`
16+
Basis: Release-facing onboarding, tours, and adoption docs.
17+
6. `GAME_DESIGN`
18+
Basis: Game design documentation and design-era notes.
19+
7. `ARCHIVE_HISTORICAL`
20+
Basis: Historical/legacy archived documentation retained for traceability.
21+
8. `ARCHITECTURE_AND_STANDARDS`
22+
Basis: Architecture, standards, technical specs, and decisions.
23+
9. `DEV_OPERATIONS`
24+
Basis: Developer operations docs not in roadmap/report/start_of_day buckets.
25+
10. `ROOT_REFERENCE`
26+
Basis: Top-level reference/entry docs in docs root.
27+
11. `OTHER_DOCS`
28+
Basis: Remaining docs paths requiring explicit future placement.
29+
30+
## Pattern Definitions
31+
32+
- `START_OF_DAY_PROTECTED`: `docs/dev/start_of_day/**`
33+
- `ROADMAPS`: `docs/dev/roadmaps/**`
34+
- `EXECUTION_REPORTS`: `docs/dev/reports/**`
35+
- `PR_BUILD_TRACKING`: `docs/pr/**`
36+
- `RELEASE_ADOPTION`: `docs/release/**`
37+
- `GAME_DESIGN`: `docs/gdd/**`
38+
- `ARCHIVE_HISTORICAL`: `docs/archive/**`
39+
- `ARCHITECTURE_AND_STANDARDS`: `docs/architecture/**`, `docs/specs/**`, `docs/standards/**`, `docs/decisions/**`
40+
- `DEV_OPERATIONS`: `docs/dev/**` excluding earlier `docs/dev/*` buckets
41+
- `ROOT_REFERENCE`: markdown files directly under `docs/`
42+
- `OTHER_DOCS`: any remaining `docs/**` path
43+
44+
## Non-Overlap Guarantee
45+
46+
- Each file is assigned by first matching rule only.
47+
- No file receives multiple buckets.
48+
- Unmatched files are forced into `OTHER_DOCS` and must be resolved in follow-up cleanup PRs.

0 commit comments

Comments
 (0)