# Hearth · editing brief

Stable ID: ENV-001. A measured layout candidate, not a finished environment.

## Purpose

A sheltered room and terrace support observing rain, using the receiver, recording a finding and meeting a neighbor. Keep the space small and readable at human eye level.

## Editable source

`source/layout.json` is the editable source for this kit. Positions and sizes in `objects` drive the exported boxes. Coordinates are meters, Y is up, +Z points into the room and −Z toward the terrace. The origin is the room/terrace threshold at finished floor height.

`room`, `terrace` and other descriptive measurements are metadata, not automatic generators. If architecture changes, update both that metadata and the affected box dimensions. Anchors are separate coordinates; move them deliberately when their supporting object moves.

## Preserve

- Room 6 × 4 m, terrace 6 × 2.4 m and 1.8 m doorway are the starting design, not empirically validated targets.
- Keep the proposed 1.2 m central circulation lane clear. The helper checks the bounded box corridor, not navigation or collisions throughout the scene.
- Keep stable object names and contact anchors. Proxies remain clearly named proxies.
- Retain wood, brass, paper and plaster families. This kit's materials are simple blockout colors, not production shaders.
- No claims of correct hand reach, engine import, UVs, gameplay or final lighting without new evidence.

## Make a revision

1. Verify the untouched kit with `python3 asset.py verify`.
2. Copy `source/layout.json` to `layout-edit.json`, then edit the copy. A small first exercise is moving `bench` from X = 2.3 to X = 2.2.
3. Run `python3 asset.py build-layout layout-edit.json --out candidate-02`.
4. Inspect `candidate-02/preview.svg` and import `candidate-02/model.obj` with its adjacent MTL into the chosen 3D tool, explicitly using meters and Y-up. Native Blender source does not exist yet.
5. Run `python3 asset.py revision --candidate candidate-02 --summary "Describe the actual change" --tool "Name the editor used"`.
6. Return the candidate directory, including `revision.json`, to the authorized studio workflow described in the kit's AGENTS.md.

The helper creates a new directory and never replaces published files. Its output is unapproved and engine import remains untested until performed. Structural checks alone do not establish visual or gameplay quality.