adom-circuit (aci)

AI-first EDA. KiCad-native. Babylon-rendered. Mouser-sourced. Renderer-owned.

Build a PCB by prompting an AI, watch every step stream into a Hydrogen webview — BOM resolution → library construction → schematic → 3D board → autoroute → DRC → final GLB. Rust owns parse + geometry + compute; Babylon 8.x owns the 3D scene; they talk scene-IR JSON over WebSocket. GLTF2Export produces the final file from the live scene — what the user watches being built is what ships.

Repo: adom-inc/adom-circuit (private) Binary name: aci

What the tool does

• aci build <prompt> — kicks off a BOM → datasheet → Mouser → library → schematic → 3D board pipeline. Spawns parallel sub-agents (one per component); LibView populates live; autoroute streams into a routing-preview scene node at 30 fps.
• aci dev — opens the Hydrogen webview with full chrome: Status Bar, Library Rail, Component HUD (refdes / footprint / nets / Mouser PN / price / stock), Timeline Strip, Global Footer with VS Code jump buttons.
• aci parity — cross-checks aci-drc / aci-erc / aci-svg against the kicad-cli oracle (via service-kicad or local install). Baseline gate before a release.
• aci doctor — health-checks every dep (service-kicad CLI → local kicad-cli → service-aci) before a build. Prints what's missing + what URL aci would hit.
• aci review <pcb> — quick DRC + ERC fidelity report without spinning up the viewer.
• aci test --visual --bless — pixel-diff visual regression harness with ralph-loop screenshots into the shotlog.
• aci share / aci clone — publish a complete project bundle to the Adom Wiki / pull someone else's project and open it locally.

Native pipeline (no shell-outs in the hot path)

Ecosystem dependencies (what aci reaches out to)

aci doctor surfaces any of these that aren't reachable from the current container, with a paste-into-Claude install prompt for each.

First-class scene features (what makes the GLB different)

• Named scene tree — every node addressable by path: board/components/U1/body, board/components/U1/pad/7, board/layers/F.Cu/trace[17], board/paste/U1/pad_1/dot[3]. Survives export as glTF extras.
• Solder-jet paste deposition — 13,627 paste dots at 250 µm planned + animated in the squirt AnimationGroup. Baked into the GLB.
• Probing workcell simulation — 100 mm GND-umbilical cover + greedy set-cover over test points. probe.* events stream during the simulation.
• InstaPCB 26-step manufacturing sim — pre-clad FR4 → lasered vias → electroplating → trace ablation → mask press → silk etch → depanel. Transient meshes (plating bath, vacuum press, silk ribbon, depanel groove) stripped from board.glb, kept in full-scene.glb.
• Three export tiers — board.glb (scene filtered to exportClass=board), full-scene.glb (everything including workcell + diagnostics + process), full project bundle (scene-ir.json + build-log.ndjson + source).

Install (Tier B)

On a fresh Adom container, say "build me a board" or "run DRC via aci" — Claude's wiki-discover skill will surface this page and offer to run the install_hint. Manual:

curl -fsSL https://wiki-ufypy5dpx93o.adom.cloud/static/apps/adom-circuit/aci -o /tmp/aci \
  && chmod +x /tmp/aci \
  && sudo install -m 0755 /tmp/aci /usr/local/bin/aci \
  && aci install \
  && aci doctor

aci doctor prints the current dep status — any missing service suggests its own install_hint.

Why Tier B (not Tier A)

Every external publisher to the Adom Wiki can only use Tier B — they can't edit gallia/install.mjs. If we publish our own flagship tool as Tier A, we never feel the friction external publishers are stuck with, and the Tier B path quietly rots. So we eat our own dog food. See adom-app-model §7 for the full doctrine.

Current status

• 97% of PLAN.md shipped — every Part 27 Critical + High + Medium + Low resolved.
• 147+ commits, 87/87 tests green, 16 Rust crates, 2 TS packages.
• Phase 4 end-to-end proven (176 WebSocket events → Babylon scene → GLB round-trip).
• Phase 15 worked-example (scripts/phase-15-worked-example.sh) green on a blank project.
• Partial gates: Phase 8 SVG pixel-compare (structural tag parity done, resvg pixel-compare deferred), Phase 9 JLCPCB gerber submission (20× draw-count parity done, external fab submission is not automatable), Phase 10e WebGPU compute-shader autorouter (feature-gated scaffold).