Locked from Andrew's 51-question interview + 14 spec images (2026-08-24). Dark cinematic FUI is the master; the twin is the product; static plates and the paper board (in-HUD) are retired in favor of live adaptive layers. Canonical: docs/MASTERPLAN.md.
The emotional artifact — watch their home exist before it exists, then watch it get built. Zero-manual usability on an iPad.
The testimonial — proof that one operator + AI pipeline delivers a $30k arch-viz contract. Metrics captured as we go; client #2 is a data swap.
Front door matches the approved mockup — angular FUI frame, SCHMITT / FOUNTAIN HILLS, live date-time, photoreal dusk-night aerial center, glowing ENTER THE TWIN.
The twin is the product: FLYOVER intro → RENDERED, all 8 modes, Adaptive Presentation Layer (hover nodes, sun/wind/energy/cost overlays, explode + section + x-ray, version scrubber).
Live Adaptive Elevations — 4 twin-rendered camera-matched views, time-of-day scrubber, landscaping + life toggles, overlay + measurement tools.
Dollhouse (great room · kitchen · primary · patio+pool, desert modern minimal, material swap + cost impact) · WALK v1 · 60–90 s hero film.
Progress engine parents check weekly — photos, % complete, decisions, inspections; budget percent-only; builder-email auto-ingest.
ORVOMA case layer — anonymized, speed + live-demo metrics, web page + 60 s video for CRE brokers and custom home builders. Plus family annotation/voice notes.
PERF BAR — first paint < 3 s on hotel wifi · twin interactive < 6 s · site < 25 MB excluding documents.
Hoerner sheets (vector PDF) ──► building-schema.json ──► glb · linework · plates Maricopa GIS + C2 survey ──► geo.json · terrain-points.json ──► terrain · parcel
| PIECE · ARCHITECTURE | STATUS | ACCEPT WHEN | |
|---|---|---|---|
| A1 | Front DoorApproved mockup: angular FUI frame, SCHMITT / FOUNTAIN HILLS, live date-time, photoreal dusk-night aerial center, glowing ENTER THE TWIN | NEW · KEY-GATED | Matches door-1 mockup |
| A2 | Board print 18×24Paper board survives only as the wall print — minimal 3 callouts | V1 BUILT | Photoreal circle + sign-off |
| A3 | Adaptive Presentation LayerHover FUI callout nodes, on-demand sun/wind/energy/cost overlays, one-click explode · section · x-ray, version timeline scrubber | NEW | Feels like one living instrument |
| B | Live Adaptive Elevations4 twin-rendered camera-matched views, time-of-day scrubber dawn→night, landscaping + life toggles, difference overlay + measurement tools | REPLACES PLATES | Overlay drift under 1 ft |
| E | DollhouseGreat room · kitchen · primary · patio+pool first; desert modern minimal; light labels, data on hover; Material Intelligence — hover any surface: live cost, lead time, carbon, alternatives (cost first, needs budget seed) | PRIORITY 1 | Room dims match A2 |
| I | Hero film 60–90 sMorph · dusk lights-on · aerial descent · interior walkthrough; lives on front door + family link + parents' TV | PRIORITY 2 · KEY-GATED | Zero geometry drift |
| F | WALK v1Exterior + great room + primary; staged key rooms; day/dusk toggle | PRIORITY 3 | 60 fps, solid walls |
| J | Progress enginePhotos · % complete · decisions · inspections; budget PERCENT-ONLY; builder-email auto-ingest + Andrew uploads | NEXT AFTER TOP 3 | Parents check weekly unprompted |
| G | FLYOVER retuneFountain → McDowell ridge · ~30 s · ambient desert wind | SHIPPED + TUNE | Path/length/audio match spec |
| H | Simulated ground truthSplat-style sim from BIM + site data, photoreal drone paths — NO pilot v1; real capture later for as-built only | UNBLOCKED | Feels like real footage |
| M | Environmental TwinReal sun + accurate shadows + desert heat overlay + wind particles + live energy score from local weather (free APIs) | WIDENED · SHARED DEP | Matches NOAA solar position |
| N | JARVIS co-pilotVoice+text agent grounded on the BIM data ("show the primary at dusk", "why this roof?") — Worker-proxied LLM, keys never client-side | P5 FLAGSHIP | Parents ask, it answers + acts |
| O | Multi-user presenceParents + Andrew + builder co-present, soft cursors, role permissions — Supabase realtime | POST-REVEAL | Two devices see each other live |
| P | AR on the lotOne-tap true-scale AR — iPhone via USDZ Quick Look (WebXR AR does not exist on iOS Safari), Android via Scene Viewer | P5 | House stands on the lot at scale |
| L | Annotation layerFamily annotations + voice notes on the twin | NEW · BACKLOG | Parents can leave a note unaided |
| K | ORVOMA case layerAnonymized 'A custom residence, Fountain Hills'; speed + live-demo metrics; web page + 60 s video; CRE brokers + home builders | LOCKED SPEC | Client #2 dry-run < 1 day |
Blender Cycles (Metal) · PIL composites · three.js — no engine · pdftocairo extraction · Maricopa GIS · Google 3D Tiles · Gemini img2img identity (key pending) · Veo/Kling films (key pending) · Tripo staging · Simulated 3DGS ground truth (no pilot v1 — Andrew) · FreeCAD IFC diff
UE5 / Twinmotion: build exactly one cinematic interior film; keep only if quality-per-hour beats Cycles. Free license, Mac-native.
D5 / Lumion / Enscape — Windows+RTX, we run macOS · Forma / TestFit / Archistar — feasibility stage, house is designed · Snaptrude / ARCHITEChTURES / Finch — would fork truth away from the stamped plans · Matterport — nothing built yet; revisit at framing.
build/metrics.md appended at every session close: hours · pieces · $ spent · accuracy stat. Seeds: sub-foot parcel · 26,460 vector paths · 128-pt terrain · $0 infra · 42-agent audit.
Gemini key (Andrew, 30 s) → board vFinal → sign-off → HUD hero → elevation plates ×4 w/ difference-overlay QC → blueprint-miniature + x-ray poster
unblocks everything visualWALK mode → schema v2 interiors → dollhouse cutaway
gate: A2 room dimensionsMorph + flyover films → single UE5/Twinmotion film evaluation → Andrew go/no-go
quality-per-hour vs CyclesLot video → 3DGS splat · Hoerner DWG diff via FreeCAD
parallel, anytimeProgress engine + budget seed → case study + template extraction → parent announcement email (the external ship)
Andrew's gates