- name
- mirage-brief-to-plan
- description
- Turn a one-paragraph idea into a Mirage world's direction before any building ("先定方向再建设") - a brief (idea, mood, references, scale, target), a site plan plan.js (bounds, regions, footprints, paths, points, viewpoints, spawn, place, sun and time), a module list with build order, a brief per module, and the project scaffold. Use when starting a new Mirage world, when the user says "I want a scene of ...", "plan the world", "site plan", "layout", "brief", or when a world has no plan.js yet.
Brief → plan
Direction first, building second. Nothing is modelled until the brief and the plan exist, because the plan is what lets several agents build at once without asking each other where things are.
1. Brief (5 minutes) → BRIEF.md
Copy references/brief-template.md. Fill every field from the user's paragraph; where it says nothing, choose
and write the choice down (do not ask unless the choice changes the whole world). One line each:
2. Plan → plan.js
Start from references/plan-template.js. Work on paper first: draw the bounds, then the regions, then the
footprints, then the paths that connect them, then the points everyone shares.
- Axes: metres, +X east, +Y up, +Z south (north is −Z). Sun azimuth is compass: 90 east, 270 west.
boundsis the walkable rectangle; keep it ≤ ~100 × 100 m (the walk grid is 0.125 m cells, baked at load). Scenery beyond it (sea, hills, skyline) is fine: it just is not walkable.walk: { yMin, yMax }: lowest and highest walkable floor, plus head room.- Every number two modules share goes in the plan: deck heights, wall heights, a door's position and width,
level heights, stair runs. Name them; modules read
plan.<thing>, never measure each other. points: what the game or another module needs to find (a door, a lever, a bench, the end of a pier).