Migrates Asteroids assets to required tool-editable structure by adding missing data folders.

BUILD_PR_LEVEL_10_05_ASSET_STRUCTURE_MIGRATION_ASTEROIDS

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -2,9 +2,12 @@ MODEL: GPT-5.4
 REASONING: high
 
 COMMAND:
-- extend Validate-All.ps1
-- add checks:
-  - required folders exist
-  - scripts in correct directories
-  - optional asset structure validation
-- ensure failures return non-zero exit
+- create missing data/ folders under:
+  games/Asteroids/assets/{sprites,tilemaps,parallax,vectors}/data
+- ensure structure exists even if empty (.gitkeep allowed)
+- do not delete or move runtime assets
+- do not modify engine code
+- commit format:
+  description first line
+  PR name last line
+- update roadmap status only

docs/dev/COMMIT_COMMENT.txt

@@ -1,3 +1,2 @@
-Extends validation runner with additional repo structure checks.
-
-BUILD_PR_LEVEL_10_04_VALIDATION_EXTENSIONS
+Create missing Asteroids asset data folders with .gitkeep placeholders while preserving runtime assets and existing structure.
+BUILD_PR_LEVEL_10_05_ASSET_STRUCTURE_MIGRATION_ASTEROIDS

docs/dev/NEXT_COMMAND.txt

@@ -1 +1 @@
-BUILD_PR_LEVEL_10_05_ASSET_STRUCTURE_VALIDATION
+BUILD_PR_LEVEL_10_06_ASSET_DATA_BOOTSTRAP

docs/dev/reports/change_summary.txt

@@ -1 +1 @@
-Adds additional validation checks.
+Adds required data/ folders for Asteroids assets.

docs/dev/reports/validation_checklist.txt

@@ -1,3 +1,3 @@
-[ ] run validation
-[ ] break folder structure → fails
-[ ] restore → passes
+[ ] run Validate-All.ps1 → PASS
+[ ] run Validate-All.ps1 -ValidateAssetStructure → PASS
+[ ] confirm data/ folders exist

docs/dev/roadmaps/MASTER_ROADMAP_HIGH_LEVEL.md

@@ -598,7 +598,7 @@
 - [x] Expand testing/validation structure
 
 ### Repo Operator + Asset Conversion Scripting Lanes
-- [ ] Existing games asset folders updated so existing images / vectors / related runtime assets can be transformed into tool-editable `data/` objects, with corresponding project JSON updates
+- [.] Existing games asset folders updated so existing images / vectors / related runtime assets can be transformed into tool-editable `data/` objects, with corresponding project JSON updates
 - [x] Add the ability for a PowerShell script to create a new game from template, including a project scaffold for the tools
 - [x] Add scripts to prep / update / delete the repo so it can be placed on a website
 - [x] Add scripts to switch between Pay-as-you-go and Codex plan modes, and scripts to input API key material and validate it

docs/pr/BUILD_PR_LEVEL_10_05_ASSET_STRUCTURE_MIGRATION_ASTEROIDS.md

@@ -0,0 +1,28 @@
+# BUILD_PR — LEVEL 10_05 — ASSET STRUCTURE MIGRATION (ASTEROIDS)
+
+## Objective
+Migrate existing Asteroids game assets into the tool-editable structure required by validation.
+
+## Scope
+- add missing `data/` folders under:
+  - sprites
+  - tilemaps
+  - parallax
+  - vectors
+- ensure structure:
+  assets/<domain>/data/*.json
+- do not remove existing runtime assets
+- prepare assets for tool editing
+
+## What to Execute
+PowerShell:
+scripts/PS/validate/Validate-All.ps1 -ValidateAssetStructure
+
+## Expected
+- BEFORE: FAIL (missing data folders)
+- AFTER: PASS
+
+## Acceptance Criteria
+- all required data folders exist
+- validator passes with -ValidateAssetStructure
+- no runtime assets broken