docs: mark Jajce scaffold proof complete

This commit is contained in:
2026-07-04 21:08:16 +02:00
parent 556d0fdc26
commit b50fae671a
4 changed files with 98 additions and 46 deletions
+36 -19
View File
@@ -234,7 +234,7 @@ makes the world pleasant to inhabit and the people pleasant to watch.
## Implementation phases
### Phase 0 — Preserve and capture the baseline
### Phase 0 — Preserve and capture the baseline 🔶 automated baseline complete
Before replacing anything:
@@ -252,6 +252,11 @@ This becomes both a regression reference and excellent before/after material.
There is a reproducible baseline showing the existing flat prototype and its
working behaviors.
`tests/flat_map_baseline_test.gd` and
`docs/baselines/FLAT_MAP_BASELINE.md` establish the executable behavior
baseline. A visual before-clip and frame-time capture remain useful content work
but do not block the architecture gate.
### Systems prerequisite — Migrate food and wood targets ✅ complete
Implement and validate the first ResourceNodes on the current flat map before
@@ -276,7 +281,7 @@ to be resource sources.
Food and wood work without their zones during normal play, resource conservation
holds, and target failure does not leave a permanent reservation.
### Phase 1 — Create the reusable world scaffold
### Phase 1 — Create the reusable world scaffold ✅ complete
Create `world/jajce/JajceWorld.tscn` with:
@@ -299,7 +304,11 @@ look-development scene.
The same `JajceWorld` instance can open in the lookdev scene and can be instanced
under a temporary runtime test without errors.
### Phase 2 — Greybox the hero composition
Implemented in `556d0fd` with dedicated Terrain3D seed data, reusable world and
lookdev scenes, environment roots, stable-ID ResourceNodes, activity markers,
and a headless scaffold test.
### Phase 2 — Greybox the hero composition ✅ initial proof complete
Sculpt by hand before attempting GIS/DEM import:
@@ -337,7 +346,12 @@ The final navigation bake still happens after terrain and props stabilize.
One static frame contains the ridge landmark, roofs, river/waterfall, and
village work area. A test agent can traverse the intended task loop.
### Systems gate — Harden simulation authority
The initial proof uses primitive ridge, fortress, terrace, house, mill, bridge,
river, and waterfall silhouettes plus a temporary baked navigation loop. The
Terrain3D seed remains flat; sculpt refinement and the final bake resume only
after the architecture gate.
### Systems gate — Harden simulation authority ⏭ next
After the scaffold, greybox, and navigation spike prove the world shape, pause
visual production and complete the mandatory architecture gate from the
@@ -567,21 +581,24 @@ The follow-up milestone is complete when:
## Immediate implementation order
1. Capture the current flat-map baseline.
2. Treat ResourceNode migration and player parity as complete.
3. Create `JajceWorld.tscn` and dedicated Terrain3D data.
4. Create `JajceLookdev.tscn` and its beauty camera.
5. Greybox the ridge, river valley, terraces, and waterfall drop.
6. Place ResourceNodes with stable IDs and only required activity markers.
7. Block out the fortress, houses, mill, and bridge.
8. Run the early navigation spike.
9. Pass the mandatory architecture gate before beauty production.
10. Establish terrain materials, lighting, water, mist, and foliage.
11. Capture “Jajce Lookdev 01.”
12. Instance `JajceWorld` into `main.tscn`.
13. Reconnect activity markers, rebake navigation, and run regression scenarios.
14. Add profession/readability presentation and the reason inspector.
15. Capture “Simulation Garden 01.”
Completed:
1. Executable flat-map baseline.
2. ResourceNode migration and player parity.
3. `JajceWorld`, dedicated 512 m Terrain3D seed, and lookdev camera.
4. Initial landmark greybox, stable-ID resources, activity markers, and
navigation spike.
Next:
1. Pass the mandatory architecture gate before beauty production.
2. Sculpt the Terrain3D ridge, river valley, terraces, and waterfall drop.
3. Establish terrain materials, lighting, water, mist, and foliage.
4. Capture “Jajce Lookdev 01.”
5. Instance `JajceWorld` into `main.tscn`.
6. Reconnect activity markers, rebake navigation, and run regression scenarios.
7. Add profession/readability presentation and the reason inspector.
8. Capture “Simulation Garden 01.”
Do not start with GIS data, a full city, a large asset pack, or more NPC
mechanics. The next proof is a beautiful stage for the systems that already