Skip to content

Commit 3feaec3

Browse files
author
DavidQ
committed
Relocate starter-project-template to tools/templates and preserve active template surfaces
1 parent 5fefcdb commit 3feaec3

10 files changed

Lines changed: 117 additions & 44 deletions

‎docs/dev/CODEX_COMMANDS.md‎

Lines changed: 19 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,29 +1,32 @@
11
MODEL: GPT-5.3-codex
2-
REASONING: low
2+
REASONING: medium
33

44
COMMAND:
5-
Execute APPLY_PR_TEMPLATES_VECTOR_NATIVE_ACTIVE_RELOCATION_VALIDATE.
5+
Execute BUILD_PR_STARTER_PROJECT_TEMPLATE_MOVE_TOOLS.
66

7-
Do not make new structural changes in this PR.
7+
Do the work in this PR. Do not ask for clarification.
88

9-
Validation steps:
10-
1. Confirm `tools/templates/vector-native-arcade/` exists.
11-
2. Confirm `templates/vector-native-arcade/` does not exist.
12-
3. Confirm `templates/starter-project-template/` still exists and is unchanged.
13-
4. Check these files now use `tools/templates/vector-native-arcade/`:
14-
- tools/shared/vectorNativeTemplate.js
15-
- tools/shared/vectorTemplateSampleGame.js
16-
- tests/tools/VectorNativeTemplate.test.mjs
17-
- games/vector-arcade-sample/README.md
18-
5. Confirm no file changes under:
9+
Required actions:
10+
1. Move:
11+
templates/starter-project-template/
12+
->
13+
tools/templates/starter-project-template/
14+
2. Update only exact references that must change for correctness after the move.
15+
3. Do NOT touch:
16+
- tools/templates/vector-native-arcade/
1917
- docs/dev/start_of_day/chatGPT/
2018
- docs/dev/start_of_day/codex/
19+
- docs/archive/
2120

2221
Create:
23-
- docs/dev/reports/templates_vector_native_active_relocation_validation.md
22+
- docs/dev/reports/starter_project_template_move_report.md
2423
- docs/dev/reports/validation_checklist.txt
2524

26-
If inconsistencies are found, report them and do not fix them in this APPLY.
25+
Validation required:
26+
- new tools/templates starter-project-template path exists
27+
- old templates/starter-project-template path no longer exists
28+
- vector-native template location remains untouched
29+
- protected start_of_day directories untouched
2730

2831
Package output to:
29-
<project folder>/tmp/APPLY_PR_TEMPLATES_VECTOR_NATIVE_ACTIVE_RELOCATION_VALIDATE.zip
32+
<project folder>/tmp/BUILD_PR_STARTER_PROJECT_TEMPLATE_MOVE_TOOLS.zip

‎docs/dev/COMMIT_COMMENT.txt‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
Validate and lock active relocation of vector-native template surface to tools/templates
1+
Relocate starter-project-template to tools/templates and preserve active template surfaces

‎docs/dev/NEXT_COMMAND.txt‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,2 @@
1-
After validation passes:
2-
BUILD_PR_STARTER_PROJECT_TEMPLATE_CLASSIFICATION_PS_FIRST
1+
After Codex completes and validation passes:
2+
APPLY_PR_STARTER_PROJECT_TEMPLATE_MOVE_TOOLS_VALIDATE

‎docs/dev/reports/change_summary.txt‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
- validation/apply lane for vector-native active relocation
2-
- confirms tools/templates location
3-
- confirms starter-project-template remains untouched
4-
- no new structural changes
1+
- codex-only execution lane
2+
- move starter-project-template to tools/templates
3+
- preserve vector-native template under tools/templates
4+
- no archive move

‎docs/dev/reports/starter_project_template_move_report.md‎

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
# Starter Project Template Move Report
2+
3+
Generated: 2026-04-12
4+
Lane: BUILD_PR_STARTER_PROJECT_TEMPLATE_MOVE_TOOLS
5+
6+
## Work Executed
7+
1. Moved directory:
8+
- `templates/starter-project-template/`
9+
- -> `tools/templates/starter-project-template/`
10+
2. Updated only direct starter-template references required for correctness:
11+
- `scripts/validate-starter-project-template.mjs`
12+
- `TEMPLATE_MANIFEST_PATH` now points to `tools/templates/starter-project-template/config/starter.project.json`
13+
- `tools/templates/starter-project-template/README.md`
14+
- Open-flow manifest path now points to `tools/templates/starter-project-template/config/starter.project.json`
15+
16+
## Guard Compliance
17+
- `tools/templates/vector-native-arcade/` untouched.
18+
- No changes under:
19+
- `docs/dev/start_of_day/chatGPT/`
20+
- `docs/dev/start_of_day/codex/`
21+
- `docs/archive/`
22+
23+
## Validation Summary
24+
- `tools/templates/starter-project-template/` exists: PASS
25+
- `templates/starter-project-template/` no longer exists: PASS
26+
- `tools/templates/vector-native-arcade/` remains untouched: PASS
27+
- required direct references updated to `tools/templates/starter-project-template/`: PASS
28+
- protected start_of_day directories untouched: PASS
29+
30+
## Notes
31+
- No archive actions performed.
32+
- No modifications were made inside `tools/templates/vector-native-arcade/`.

‎docs/dev/reports/validation_checklist.txt‎

Lines changed: 12 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,32 +1,25 @@
1-
APPLY_PR_TEMPLATES_VECTOR_NATIVE_ACTIVE_RELOCATION_VALIDATE
1+
BUILD_PR_STARTER_PROJECT_TEMPLATE_MOVE_TOOLS
22
Validation Checklist
33
Generated: 2026-04-12
44

5-
[PASS] tools/templates/vector-native-arcade exists
5+
[PASS] new tools/templates starter-project-template path exists
66
Evidence:
7-
- `Test-Path tools/templates/vector-native-arcade` -> `True`
8-
9-
[PASS] templates/vector-native-arcade no longer exists
10-
Evidence:
11-
- `Test-Path templates/vector-native-arcade` -> `False`
7+
- `Test-Path tools/templates/starter-project-template` -> `True`
128

13-
[PASS] templates/starter-project-template exists and is unchanged
9+
[PASS] old templates/starter-project-template path no longer exists
1410
Evidence:
15-
- `Test-Path templates/starter-project-template` -> `True`
16-
- `git diff --name-only -- templates/starter-project-template` -> no entries
11+
- `Test-Path templates/starter-project-template` -> `False`
1712

18-
[PASS] required four files reference tools/templates/vector-native-arcade
13+
[PASS] vector-native template location remains untouched
1914
Evidence:
20-
- positive path matches found in all four files
15+
- `Test-Path tools/templates/vector-native-arcade` -> `True`
16+
- `git diff --name-only -- tools/templates/vector-native-arcade` -> no entries
2117

22-
[PASS] old bare path absent in required four files
18+
[PASS] required direct starter-template references updated for correctness
2319
Evidence:
24-
- `rg --pcre2 -n "(?<!tools/)templates/vector-native-arcade/|(?<!tools/)templates/vector-native-arcade\b" <4 files>` -> no matches
20+
- `scripts/validate-starter-project-template.mjs` uses `tools/templates/starter-project-template/config/starter.project.json`
21+
- `tools/templates/starter-project-template/README.md` uses `tools/templates/starter-project-template/config/starter.project.json`
2522

2623
[PASS] protected start_of_day directories untouched
2724
Evidence:
28-
- `git diff --name-only -- docs/dev/start_of_day/chatGPT docs/dev/start_of_day/codex` -> no entries
29-
30-
[PASS] APPLY lane did not perform structural changes
31-
Evidence:
32-
- validation/report-only execution
25+
- `git diff --name-only -- docs/dev/start_of_day/chatGPT docs/dev/start_of_day/codex` -> no entries

‎docs/pr/BUILD_PR_STARTER_PROJECT_TEMPLATE_MOVE_TOOLS.md‎

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
# BUILD_PR_STARTER_PROJECT_TEMPLATE_MOVE_TOOLS
2+
3+
## PR Purpose
4+
Execute one narrow active-relocation lane for `starter-project-template`.
5+
6+
## Scope
7+
This PR is single-purpose:
8+
- move `templates/starter-project-template/`
9+
- to `tools/templates/starter-project-template/`
10+
- update only exact references if any are required for correctness
11+
- do not archive anything
12+
- do not touch `tools/templates/vector-native-arcade/`
13+
14+
## Exact Target Paths
15+
### Must move if source exists
16+
- `templates/starter-project-template/`
17+
- to `tools/templates/starter-project-template/`
18+
19+
### Must create or overwrite
20+
- `docs/dev/reports/starter_project_template_move_report.md`
21+
- `docs/dev/reports/validation_checklist.txt`
22+
23+
### May modify only if required for correctness
24+
- direct references to `templates/starter-project-template/`
25+
26+
## Required Work
27+
1. Move `templates/starter-project-template/` to `tools/templates/starter-project-template/`.
28+
2. Update only exact references that must change for correctness after the move.
29+
3. Leave `tools/templates/vector-native-arcade/` untouched.
30+
4. Do not archive anything.
31+
5. Do not touch unrelated cleanup targets.
32+
6. Do not change anything under:
33+
- `docs/dev/start_of_day/chatGPT/`
34+
- `docs/dev/start_of_day/codex/`
35+
36+
## Validation
37+
- `tools/templates/starter-project-template/` exists
38+
- `templates/starter-project-template/` no longer exists
39+
- `tools/templates/vector-native-arcade/` remains untouched
40+
- any required references now point to `tools/templates/starter-project-template/`
41+
- protected start_of_day directories untouched
42+
43+
## Expected Output
44+
Package output to:
45+
- `<project folder>/tmp/BUILD_PR_STARTER_PROJECT_TEMPLATE_MOVE_TOOLS.zip`

‎scripts/validate-starter-project-template.mjs‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ const __filename = fileURLToPath(import.meta.url);
1313
const __dirname = path.dirname(__filename);
1414
const repoRoot = path.resolve(__dirname, "..");
1515

16-
const TEMPLATE_MANIFEST_PATH = "templates/starter-project-template/config/starter.project.json";
16+
const TEMPLATE_MANIFEST_PATH = "tools/templates/starter-project-template/config/starter.project.json";
1717
const REPORT_PATH = "docs/dev/reports/starter_project_template_validation.txt";
1818

1919
function assert(condition, message, issues) {

templates/starter-project-template/README.md renamed to tools/templates/starter-project-template/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ This template is a single reusable project manifest for the shared tools project
1010
## Open flow
1111
1. Open any active first-class tool.
1212
2. Use the shared shell `Open Project` action.
13-
3. Select `templates/starter-project-template/config/starter.project.json`.
13+
3. Select `tools/templates/starter-project-template/config/starter.project.json`.
1414

1515
## Shared references used
1616
- vector: `templates/vector-native-arcade/assets/vectors/template-player.vector.json`

templates/starter-project-template/config/starter.project.json renamed to tools/templates/starter-project-template/config/starter.project.json

File renamed without changes.

0 commit comments

Comments
 (0)