AI Flow

@@ -58,7 +58,24 @@ Start from a known-good layout of the same editor version (a published workcell ```  - `sku` is the published molecule's wiki identity (molecule-publish comes first).-- `position` is the layout coordinate of the molecule's FL pin (MP1), in mm; `rotation.z` in degrees. Large-pin molecules and scaffolds sit on the base scaffold's grid (16 + 32 n). A medium-pin molecule needs a LrgMed user scaffold (adom/scaffold-lrgmed-<W>x<H>: large pins at the corners on the 32 mm base grid, medium contacts on a 4 mm grid): put the scaffold's FL large pin on the base grid and the molecule's FL pin on the scaffold's 4 mm grid, so the molecule's pin span must be a multiple of 4 mm. Each stacked level adds about 8.4 mm of z in the reference layouts; the editor snaps it when the layout opens.+- `position` is the layout coordinate of the molecule's FL pin (MP1), in mm; `rotation.z` in degrees; `z` is where the+  layer's model origin goes. **Every machine pin goes into a machine contact of the layer below, on every layer**+  (John, 2026-10-06):+  - Large-pin molecules and user scaffolds sit on the base scaffold's large contacts: a 32 mm grid starting 16 mm in+    (16 + 32 n, 18 x 18 over 576 mm).+  - A medium-pin molecule needs a LrgMed user scaffold (adom/scaffold-lrgmed-<W>x<H>): its corner large pins on the+    base grid, its medium contacts at **FL + 4 + 8 k mm** (an 8 mm pitch offset 4 mm from its corner pins; NOT every+    4 mm, read them from the scaffold page's circuit.json). The molecule's FL pin goes on one of them, so its pin+    span must be a multiple of 8 mm. Example: scaffold FL at (240, 464) puts contacts at x, y = 236, 244, 252, ...;+    a molecule FL at y 488 misses them by 4 mm, at 484 it lands.+  - Z: each board rests ON the layer below (on the contacts' rims), never sunk into it and never floating so high+    its pins miss the contacts (medium short pins reach 4.95 mm below their board, large short 10.34 mm). The old+    "about 8.4 mm per level" put the board on the scaffold's pin HEADS, with its pins in the air; a scaffold GLB's+    origin is its board's mid-plane, so z 0 sinks it 0.7 mm into the base.+  - Do not place it by hand: `adom-aiflow-probing stack` checks every pin over a contact and every board seated,+    from the scaffold page's circuit.json, the molecule's footprint JSON and the real GLBs, and names the exact+    position that fixes each problem; `stack --fix` writes them (backup kept). Then `wires check` / `wires route`+    (a moved board breaks hand routes), compile and twin. - `pins` and `pinType`: copy what the molecule's import gives for its pin size; do not invent values. - `contactPosition` is molecule-local (mm from MP1; z is the footprint JSON's `contact_z`, 2.8 mm for medium contacts). `contactName` matches the board's reference. - Check the layout against the geometry before handing it over, in the real twin, never in a homemade viewer: