# adom-step v0.1.0 — Feature Tour

**Target duration:** ~75 s (6 clips × ~10–15 s each)
**Recorded:** 2026-05-03
**Final output:** `~/project/recordings/adom-step-0.1.0-tour.webm`
**Wiki target:** `apps/adom-step`
**Hero frame:** clip 1 — VL53L8CX with components outline expanded.

## Dependencies

- `adom-tts` 0.1.0 (Adom's edge-tts wrapper, en-US-AndrewMultilingualNeural)
- `adom-desktop` (pup recording — Hydrogen is busy with adom-step itself)
- `ffmpeg 6+`
- `adom-step` 0.1.0 — the binary under test
- `service-step2glb` reachable

## Recording config

- **Surface:** pup (Hydrogen has the adom-step viewer in it)
- **Voice:** `en-US-AndrewMultilingualNeural` (default)
- **fps:** 15, quality 75
- **Captions:** rendered inside the page via injected `<div>` (pup path,
  no `adom-cli hydrogen caption show` available)

## Scenes

| # | id | Caption (on-screen) | Narration (TTS, phonetics applied) | Target | Driver |
|---|---|---|---|---|---|
| 1 | intro | `adom step v0.1.0 — STEP viewer` | `This is adom step version zero point one — a fusion three sixty style viewer for STEP files.` | 8 s | Open VL53L8CX. Show components outline + canvas. |
| 2 | outline | `Components outline — every assembly node` | `The left sidebar walks the assembly hierarchy. Every body, pin, and contact pad is its own row.` | 12 s | Expand the L G A 16 EP group. Hover a contact — the mesh glows in the canvas. |
| 3 | measure | `Measure — millimeters and mils` | `Smart pick the measure tool snaps to vertex, edge, face, or body. Two clicks gives distance in millimeters and mils, plus delta x y z and the angle.` | 14 s | Click Measure. Pick face on contact 1, face on contact 9. HUD shows mm + mils. |
| 4 | strobe | `Strobe — flash each detected pad` | `Strobe verifies pin clustering by flashing each detected pad one at a time. Seventeen pads on this V L 5 3 L 8 — sixteen L G A plus the exposed thermal pad.` | 14 s | Click Strobe. Let it run through ~6 contacts. |
| 5 | reveal | `Right-click in canvas — Reveal in Components Outline` | `Right click any part in the three D viewer to find it in the outline. Hide it from the menu and the outline row flashes so you can find it again. Every action is undo redo.` | 12 s | Right-click body → Reveal. Right-click → Hide. Outline row flashes. |
| 6 | wago | `Through-hole pin detection on a WAGO terminal block` | `Geometry based pin discovery walks the model bottom and finds tall thin sub meshes. On this WAGO terminal block it surfaces seven through hole legs even when the manufacturer didn't tag them as metal.` | 15 s | Open WAGO. Show "Pins 7" filter chip. Hover one detected pin. |

## TTS pronunciation notes

- `adom-step` → narration says **"adom step"** (two words).
- `0.1.0` → **"zero point one"**.
- `STEP` (file format) → **"STEP"** (TTS gets it right).
- `VL53L8CX` / `VL53L8` → **"V L 5 3 L 8 C X"** / **"V L 5 3 L 8"**.
- `LGA` → **"L G A"**.
- `3D` → **"three D"**.
- `Fusion 360` → **"fusion three sixty"**.
- `xyz` (delta) → **"x y z"** (spell letters).
- `WAGO` → leave as **"WAGO"** (TTS reads it as "way-go", which is correct).

## Reproduction

A teammate (or another Claude) re-records the same demo with:

```bash
cd ~/project/adom-step
# Re-render TTS for any narration changes:
for id in intro outline measure strobe reveal wago; do
  adom-tts say "<narration>" --out /tmp/adom-step-demo/tts/${id}.mp3
done
# Drive each clip via the pup record-eval-stop loop captured in
# this file's "Driver" column. Mux + manifest add per clip.
# Final: ffmpeg concat → upload.
```

## Known issues

- Hydrogen is occupied by the adom-step app under test, so this
  demo records via **pup** on the user's desktop (per
  demo-recording skill's pup-with-foreground-rebump pattern).
  Storyboard review skipped — user explicitly said "watch later."