Developers · lead
Integration
What the alpha took from each workstream, the order the lead follows, and the work that each owner still has.
Content checked 2 November 2026
Rules for every integration#
- Codex is the only integrator. Agents commit on their own branches. A report is evidence, not acceptance.
- Pin, do not merge. The alpha copies reviewed files from exact commits and records them in
INTEGRATION.jsonandUPDATED-PINS.json. Nobody merges a whole worktree. - Do not rerun the old snapshot tool over reviewed overrides. Keep the existing
Placeholderbranch and build command. - Approved art needs its data. A background goes in together with its anchors, masks, collision and state layers, never as a picture swap alone.
- A passing component test is not a playable game. Acceptance needs the real route, from a fresh save and a migrated save, without teleport commands.
What the alpha took from each workstream#
| Workstream | Pinned work in the alpha | Notes |
|---|---|---|
| Claude B · turn engine and systems | Engine 7d9c46c; services v3, side-story gates and roster rules | Reviewed Vessel overrides recorded apart. Dirty Tracts and Hearth retunes were not taken. |
| Claude A · rooms | Room snapshot 15b5e627 (21×14 boards on 24×20 squares) | Newer retunes and the shuffle forges are still running. |
| Run HUDs | a893e4f | Goal strips, action bar, unit cards and results. |
| Room building | Encounter shells at 8742b7c (16 shells) | All approved. |
| Microglia motion | Action tendrils f816848 | Pore-aligned roots. |
| VFX | Eight approved turn groups, plus menu, trade, home and movement effects | Effects play after a successful transaction. |
| Character sprites | Tracts and Vessel actor art (b90fe68, 77c147f); named directional and tending animation | Later cast not installed. |
| Environment art | H15 Hearth, S13 Starwell | Replaced H14 and S11. |
| Movement and Map | Threadway geometry and streaming | Upper stairs in Commons, Tea house and apartments still disconnected. |
The order the lead follows#
- Set the reviewed baseline. Record the approved source, owner and status of each subsystem.
- One shared state and transition contract for campaign, roster, services, receipts, home facts, lessons and position, with migrations.
- Finish the physical world: approved maps with their geometry and residents, the Threadway link, the Places dialog and touch. Mostly done in
69c7b54. - One real outing loop: prepare at Hearth → walk the route → lesson → turn room → verified outcome → reward → return → home effects → reload. Done for single rooms.
- Connect the delivered systems: cast and actions, shops and podium, Imprints, tools and upgrades, quests and recruits, automatic duties, strain, disturbances and effects.
- Stage the wider campaign: story gates, first-skill teaching, validated room pools, the five banked repairs, Starwell, home growth, the Meadow refuge and the Act V injury.
- Release acceptance: all suites on
Placeholder, novice routes, target devices, then a check of the published site.
What each owner still has#
| Owner | Work |
|---|---|
| Codex (lead) | Host Hearth disturbances after Ready; generated outings; Studios drills; later story staging; remaining host actions (paid Call, Archive charting, Tea visits, absence effects, epilogue); release provenance and device checks. |
| Scene author | Playable II2, II3 and II5 scenes and the later causal scenes. |
| Claude A | Hearth retune and verdicts on the new floor; the generated-outing assembler and shuffle engine; the eight Studios drills as turn rooms. |
| Claude B | Rules for turn-based home disturbances; location bands; contracts for the remaining host actions. |
| Movement and Map | Upper Threadway stairs and landings; optional further compression. |
| Character team | Production animation for Nell, Stella, Aster, Vessa and Wick; Bram’s redrawn turned views. |
| Environment and Room building | Remaining interiors and act-state art; shells for new rooms. |
Contracts in force#
| Contract | Where |
|---|---|
Integrated game boundary (session.game v1) | INTERFACES.md on Placeholder, section of 2 November |
Alpha encounter boundary (session.alpha, historical) | Same file |
| CR-NAV-01 polygon regions; CR-NAV-02 depth walking and live Threadway fixture | INTERFACES.md on main and Placeholder |
| Turn-based rules | Claude B, 215bfbf88:docs/game-balance/31-turn-based-encounters.md |
See also Architecture and the Workstreams article.