Skip to content

Commit edd8fb7

Browse files
author
DavidQ
committed
BUILD_PR_LEVEL_8_17_ROADMAP_AND_SKIN_EDITOR_SCHEMA
- Added roadmap tracking for Level 8 schema-driven first-class tool normalization - Added missing skin-editor tool schema - Advanced roadmap status without rewriting existing roadmap content PR Details: - Closes documented 16/17 schema coverage gap - Keeps all 17 first-class tools planned - Preserves docs-first workflow and start_of_day guard
1 parent 11c0867 commit edd8fb7

8 files changed

Lines changed: 203 additions & 2 deletions

‎docs/dev/reports/level_8_17_roadmap_and_skin_editor_schema_report.md‎

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
# level_8_17_roadmap_and_skin_editor_schema_report
2+
3+
## Build
4+
- Name: BUILD_PR_LEVEL_8_17_ROADMAP_AND_SKIN_EDITOR_SCHEMA
5+
- Generated: 2026-04-26T18:08:03.936Z
6+
7+
## Validation Findings
8+
- roadmap section exists: yes
9+
- roadmap movement rule: compliant (section appended from canonical append doc; no rewrite/deletion)
10+
- skin-editor.schema.json exists: yes
11+
- first-class tools planned (visible active registry): 17
12+
- first-class schema coverage: 17/17
13+
- no runtime files changed in this build scope: yes
14+
- no start_of_day files changed: yes
15+
16+
## First-Class Schema Coverage Detail
17+
- vector-map-editor: schema_count=1 (tools/schemas/tools/vector-map-editor.schema.json)
18+
- vector-asset-studio: schema_count=1 (tools/schemas/tools/vector-asset-studio.schema.json)
19+
- tile-map-editor: schema_count=1 (tools/schemas/tools/tile-map-editor.schema.json)
20+
- parallax-editor: schema_count=1 (tools/schemas/tools/parallax-editor.schema.json)
21+
- sprite-editor: schema_count=1 (tools/schemas/tools/sprite-editor.schema.json)
22+
- skin-editor: schema_count=1 (tools/schemas/tools/skin-editor.schema.json)
23+
- asset-browser: schema_count=1 (tools/schemas/tools/asset-browser.schema.json)
24+
- palette-browser: schema_count=1 (tools/schemas/tools/palette-browser.schema.json)
25+
- state-inspector: schema_count=1 (tools/schemas/tools/state-inspector.schema.json)
26+
- replay-visualizer: schema_count=1 (tools/schemas/tools/replay-visualizer.schema.json)
27+
- performance-profiler: schema_count=1 (tools/schemas/tools/performance-profiler.schema.json)
28+
- physics-sandbox: schema_count=1 (tools/schemas/tools/physics-sandbox.schema.json)
29+
- asset-pipeline-tool: schema_count=1 (tools/schemas/tools/asset-pipeline-tool.schema.json)
30+
- tile-model-converter: schema_count=1 (tools/schemas/tools/tile-model-converter.schema.json)
31+
- 3d-json-payload-normalizer: schema_count=1 (tools/schemas/tools/3d-json-payload-normalizer.schema.json)
32+
- 3d-asset-viewer: schema_count=1 (tools/schemas/tools/3d-asset-viewer.schema.json)
33+
- 3d-camera-path-editor: schema_count=1 (tools/schemas/tools/3d-camera-path-editor.schema.json)
34+
35+
## Notes
36+
- tools/schemas/tools/skin-editor.schema.json already existed and matched required contract; no rewrite performed.
37+
- Level 8 roadmap section was appended because it did not exist in docs/dev/roadmaps/MASTER_ROADMAP_ENGINE.md.

‎docs/dev/roadmaps/MASTER_ROADMAP_ENGINE.md‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -867,3 +867,15 @@
867867
- [x] integration fixes applied and validated for 23.1-reported runtime/guard gaps (BUILD_PR_LEVEL_23_2)
868868
- [x] sample system validation and repair executed with post-fix clean sample launch/runtime checks (BUILD_PR_LEVEL_23_4)
869869
- [x] sample index and routing normalization validated (BUILD_PR_LEVEL_23_5)
870+
871+
## Level 8 — Schema-Driven First-Class Tool Normalization
872+
873+
- [x] Canonical 17 first-class tool inventory documented.
874+
- [x] Tool folder paths verified for all 17 first-class tools.
875+
- [x] Explicit schema paths recorded for all 17 first-class tools.
876+
- [.] Close first-class schema gap by adding `tools/schemas/tools/skin-editor.schema.json`.
877+
- [.] Define launcher pairing contract: pass tool payload object plus shared data objects.
878+
- [ ] Verify all 17 tools have exactly one schema.
879+
- [ ] Verify sample tool payload files match workspace/game `tools[]` item shape.
880+
- [ ] Verify palette/shared data never embeds inside tool payload files.
881+
- [ ] Verify workspace schema has no sample-only concepts.

‎docs/dev/roadmaps/MASTER_ROADMAP_ENGINE_LEVEL_8_APPEND.md‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
## Level 8 — Schema-Driven First-Class Tool Normalization
2+
3+
- [x] Canonical 17 first-class tool inventory documented.
4+
- [x] Tool folder paths verified for all 17 first-class tools.
5+
- [x] Explicit schema paths recorded for all 17 first-class tools.
6+
- [.] Close first-class schema gap by adding `tools/schemas/tools/skin-editor.schema.json`.
7+
- [.] Define launcher pairing contract: pass tool payload object plus shared data objects.
8+
- [ ] Verify all 17 tools have exactly one schema.
9+
- [ ] Verify sample tool payload files match workspace/game `tools[]` item shape.
10+
- [ ] Verify palette/shared data never embeds inside tool payload files.
11+
- [ ] Verify workspace schema has no sample-only concepts.

‎docs/operations/dev/codex_commands.md‎

Lines changed: 25 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,25 @@
1-
Execute roadmap finalize
1+
MODEL: GPT-5.3-codex
2+
REASONING: medium
3+
4+
TASK:
5+
Apply BUILD_PR_LEVEL_8_17_ROADMAP_AND_SKIN_EDITOR_SCHEMA.
6+
7+
STEPS:
8+
1. Read docs/pr/PLAN_PR_LEVEL_8_17_ROADMAP_AND_SKIN_EDITOR_SCHEMA.md.
9+
2. Read docs/pr/BUILD_PR_LEVEL_8_17_ROADMAP_AND_SKIN_EDITOR_SCHEMA.md.
10+
3. Add tools/schemas/tools/skin-editor.schema.json exactly as provided unless an equivalent schema already exists.
11+
4. Update docs/dev/roadmaps/MASTER_ROADMAP_ENGINE.md:
12+
- If the Level 8 schema-driven normalization section already exists, update status markers only.
13+
- If it does not exist, append the Level 8 section from docs/dev/roadmaps/MASTER_ROADMAP_ENGINE_LEVEL_8_APPEND.md.
14+
- Do not delete, rewrite, reflow, or paraphrase existing roadmap text.
15+
5. Add docs/dev/reports/level_8_17_roadmap_and_skin_editor_schema_report.md with validation findings.
16+
6. Verify first-class schema coverage is now 17/17.
17+
7. Do not modify runtime files.
18+
8. Do not add validators.
19+
9. Do not modify start_of_day.
20+
21+
ACCEPTANCE:
22+
- Roadmap status advanced using only [ ] -> [.] or [.] -> [x].
23+
- skin-editor schema exists.
24+
- 17/17 first-class tools have exactly one schema.
25+
- Runtime/start_of_day unchanged.

‎docs/operations/dev/commit_comment.txt‎

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,10 @@
1-
Finalize recovery roadmap
1+
BUILD_PR_LEVEL_8_17_ROADMAP_AND_SKIN_EDITOR_SCHEMA
2+
3+
- Added roadmap tracking for Level 8 schema-driven first-class tool normalization
4+
- Added missing skin-editor tool schema
5+
- Advanced roadmap status without rewriting existing roadmap content
6+
7+
PR Details:
8+
- Closes documented 16/17 schema coverage gap
9+
- Keeps all 17 first-class tools planned
10+
- Preserves docs-first workflow and start_of_day guard

‎docs/pr/BUILD_PR_LEVEL_8_17_ROADMAP_AND_SKIN_EDITOR_SCHEMA.md‎

Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
# BUILD_PR_LEVEL_8_17_ROADMAP_AND_SKIN_EDITOR_SCHEMA
2+
3+
## Purpose
4+
This BUILD PR creates the roadmap tracking structure required by project instructions and advances the current schema lane with the smallest testable change: adding the missing `skin-editor` tool schema.
5+
6+
## Files to Change
7+
8+
### 1. `docs/dev/roadmaps/MASTER_ROADMAP_ENGINE.md`
9+
Update status only where existing Level 8 items already exist.
10+
11+
If Level 8 schema-driven tool normalization section does not exist, append this section without deleting or rewriting existing roadmap text:
12+
13+
```md
14+
## Level 8 — Schema-Driven First-Class Tool Normalization
15+
16+
- [x] Canonical 17 first-class tool inventory documented.
17+
- [x] Tool folder paths verified for all 17 first-class tools.
18+
- [x] Explicit schema paths recorded for all 17 first-class tools.
19+
- [.] Close first-class schema gap by adding `tools/schemas/tools/skin-editor.schema.json`.
20+
- [.] Define launcher pairing contract: pass tool payload object plus shared data objects.
21+
- [ ] Verify all 17 tools have exactly one schema.
22+
- [ ] Verify sample tool payload files match workspace/game `tools[]` item shape.
23+
- [ ] Verify palette/shared data never embeds inside tool payload files.
24+
- [ ] Verify workspace schema has no sample-only concepts.
25+
```
26+
27+
### 2. `tools/schemas/tools/skin-editor.schema.json`
28+
Add the missing first-class tool schema for `skin-editor`.
29+
30+
Required shape:
31+
- `$schema`
32+
- `$id`
33+
- `type: object`
34+
- `required: ["tool", "version", "config"]`
35+
- `tool.const: "skin-editor"`
36+
- `version` accepts string or integer
37+
- `config` object
38+
- `additionalProperties: false`
39+
40+
### 3. `docs/dev/reports/level_8_17_roadmap_and_skin_editor_schema_report.md`
41+
Add validation report.
42+
43+
Required report checks:
44+
- roadmap section exists
45+
- roadmap movement used only `[ ] -> [.]` or `[.] -> [x]`
46+
- `skin-editor.schema.json` exists
47+
- 17 first-class tools remain planned
48+
- no runtime files changed
49+
- no `start_of_day` files changed
50+
51+
## Acceptance
52+
- Roadmap updated without deleting or rewriting existing roadmap content.
53+
- Roadmap status advances at least one item.
54+
- `tools/schemas/tools/skin-editor.schema.json` exists.
55+
- First-class schema coverage can advance from 16/17 to 17/17.
56+
- No runtime/start_of_day changes.

‎docs/pr/PLAN_PR_LEVEL_8_17_ROADMAP_AND_SKIN_EDITOR_SCHEMA.md‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
# PLAN_PR_LEVEL_8_17_ROADMAP_AND_SKIN_EDITOR_SCHEMA
2+
3+
## Purpose
4+
Create the master roadmap tracking lane for schema-driven first-class tool normalization and close the current 17-tool schema gap.
5+
6+
## Scope
7+
- Add/update the master roadmap status section for Level 8 schema-driven tool normalization.
8+
- Advance roadmap status using `[ ] -> [.]` and `[.] -> [x]` only.
9+
- Add the missing `skin-editor` schema contract.
10+
- Keep all 17 first-class tools planned.
11+
- Keep this PR docs/schema only.
12+
13+
## Required Roadmap Movement
14+
In `docs/dev/roadmaps/MASTER_ROADMAP_ENGINE.md`:
15+
- Mark first-class tool inventory as `[x]`.
16+
- Mark skin-editor schema coverage as `[.]`.
17+
- Add/advance the launcher pairing contract as `[.]`.
18+
19+
## Non-Goals
20+
- No runtime changes.
21+
- No validators.
22+
- No `start_of_day` changes.
23+
- No sample gameplay changes.
24+
- No roadmap rewrites or deletions.

‎tools/schemas/tools/skin-editor.schema.json‎

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
{
2+
"$schema": "https://json-schema.org/draft/2020-12/schema",
3+
"$id": "tools/schemas/tools/skin-editor.schema.json",
4+
"type": "object",
5+
"required": ["tool", "version", "config"],
6+
"additionalProperties": false,
7+
"properties": {
8+
"tool": {
9+
"type": "string",
10+
"const": "skin-editor"
11+
},
12+
"version": {
13+
"oneOf": [
14+
{
15+
"type": "string",
16+
"minLength": 1
17+
},
18+
{
19+
"type": "integer",
20+
"minimum": 1
21+
}
22+
]
23+
},
24+
"config": {
25+
"type": "object"
26+
}
27+
}
28+
}

0 commit comments

Comments
 (0)