|
1 | 1 | # BUILD PR — Games PacmanLite Next Template Baseline |
2 | 2 |
|
3 | 3 | ## Purpose |
4 | | -Create a safe, non-destructive template-aligned baseline alongside the existing PacmanLite game. |
| 4 | +Create a safe template-aligned baseline alongside existing PacmanLite. |
5 | 5 |
|
6 | | -## Why This Shape |
7 | | -We want less back-and-forth, but we still need one clear PR purpose. |
8 | | -This BUILD bundles all baseline setup work needed for the next migration lane while keeping the current playable game intact. |
9 | | - |
10 | | -## Single PR Purpose |
11 | | -Establish `games/PacmanLite_next/**` as the accepted template-based migration baseline. |
12 | | - |
13 | | -## Scope (STRICT) |
14 | | -- Create `games/PacmanLite_next/**` |
15 | | -- Use `games/_template/**` as the source of truth |
16 | | -- Preserve the current `games/PacmanLite/**` implementation unchanged |
17 | | -- Keep `games/PacmanLite_next/**` non-playable in this PR |
18 | | -- Make the new baseline immediately testable in browser |
19 | | - |
20 | | -## Source Of Truth |
21 | | -- `games/_template/**` |
22 | | - |
23 | | -## Target Paths (EXACT) |
24 | | -Source: |
25 | | -- `games/_template/**` |
26 | | - |
27 | | -Destination: |
28 | | -- `games/PacmanLite_next/**` |
29 | | - |
30 | | -## Bundled Tasks Included In This BUILD |
31 | | -1. Copy/adapt the accepted template baseline into `games/PacmanLite_next/**` |
32 | | -2. Preserve the minimal reusable folder skeleton |
33 | | -3. Preserve the aligned engine/theme shell baseline |
34 | | -4. Ensure `games/PacmanLite_next/index.html` is browser-openable and testable |
35 | | -5. Ensure the required status text renders on the canvas |
36 | | -6. Ensure no gameplay boots |
37 | | -7. Ensure no current PacmanLite files are modified |
| 6 | +## Scope |
| 7 | +- Create games/PacmanLite_next/** |
| 8 | +- Source: games/_template/** |
| 9 | +- Do NOT modify games/PacmanLite/** |
38 | 10 |
|
39 | 11 | ## Required Behavior |
40 | | -`games/PacmanLite_next/index.html` MUST: |
41 | | -- show the aligned shell/theme baseline from the accepted template |
42 | | -- render a visible canvas |
43 | | -- render this text on the canvas: |
44 | | - |
| 12 | +- Canvas visible |
| 13 | +- Render text on canvas: |
45 | 14 | HTML Says |
46 | 15 | Template Status |
47 | 16 | This template intentionally does not boot gameplay. |
48 | | - |
49 | | -- not boot gameplay |
50 | | -- not load PacmanLite gameplay |
51 | | -- not load Asteroids gameplay |
52 | | -- not depend on copied game-specific assets |
53 | | - |
54 | | -## Allowed Operations |
55 | | -- create `games/PacmanLite_next/**` |
56 | | -- copy/adapt files from `games/_template/**` |
57 | | -- keep `.gitkeep` placeholders |
58 | | -- adjust only what is required so the copied baseline works correctly at the new destination path |
59 | | - |
60 | | -## Explicit Non-Goals |
61 | | -- DO NOT modify `games/PacmanLite/**` |
62 | | -- DO NOT migrate gameplay in this PR |
63 | | -- DO NOT perform canonical replacement in this PR |
64 | | -- DO NOT refactor engine/shared code |
65 | | -- DO NOT change other games |
66 | | -- DO NOT add PacmanLite assets, ghosts, maps, scoring, audio, or rules |
67 | | -- DO NOT expand `_next` beyond the accepted template baseline |
68 | | - |
69 | | -## Fail-Fast Conditions |
70 | | -STOP with no changes if any of the following are true: |
71 | | -- creating `games/PacmanLite_next/**` would require modifying `games/PacmanLite/**` |
72 | | -- the baseline cannot work at the new destination without gameplay code |
73 | | -- any path outside `games/PacmanLite_next/**` must be changed, other than reading `games/_template/**` |
74 | | -- more than baseline/template alignment is required |
| 17 | +- Non-playable |
75 | 18 |
|
76 | 19 | ## Acceptance Criteria |
77 | | -- `games/PacmanLite_next/**` exists |
78 | | -- it matches the accepted template baseline structure |
79 | | -- canvas is visible |
80 | | -- required status text renders on the canvas |
81 | | -- no gameplay boots |
82 | | -- no console errors |
83 | | -- `games/PacmanLite/**` remains unchanged |
84 | | - |
85 | | -## Validation Steps |
86 | | -1. Open `games/PacmanLite_next/index.html` |
87 | | -2. Confirm: |
88 | | - - canvas is visible |
89 | | - - shell/theme baseline is present |
90 | | - - the three required lines render on the canvas |
91 | | - - no gameplay starts |
92 | | - - no console errors |
93 | | -3. Confirm `games/PacmanLite/**` was not modified |
| 20 | +- PacmanLite_next exists |
| 21 | +- Canvas renders required text |
| 22 | +- No gameplay boots |
| 23 | +- Original PacmanLite unchanged |
94 | 24 |
|
95 | | -## Output Requirement |
96 | | -Codex must package: |
97 | | -`<project folder>/tmp/BUILD_PR_GAMES_PACMANLITE_NEXT_TEMPLATE_BASELINE_delta.zip` |
| 25 | +## Output |
| 26 | +<project folder>/tmp/BUILD_PR_GAMES_PACMANLITE_NEXT_TEMPLATE_BASELINE_delta.zip |
0 commit comments