adom-circuit — AI-first EDA (aci)
Public UnreviewedBuild a PCB by prompting an AI, watch every step stream into a Hydrogen webview. Rust-native pipeline (parse, DRC, ERC, gerber, SVG, autorouter) + Babylon.js 8.x 3D scene. Mouser-first BOM. Shares one
name: adom-circuit
description: AI-first EDA tool for building PCBs — Rust pipeline + Babylon.js 3D viewer in a Hydrogen webview, native KiCad file I/O, native DRC/ERC, tscircuit autorouter, Mouser-first BOM, solder-jet paste deposition, 26-step InstaPCB manufacturing sim, 100mm probing-workcell sim. Binary is aci, repo is adom-circuit. Use when the user asks to design a PCB via AI, build a board from a prompt, watch a board being built, or when they say words like build a board, design a pcb, ai-first eda, adom circuit, asci, aci build, make a circuit board, dev board, breakout board, iCE40 board, 3D pcb preview with animations, paste-jet simulation, kicad pipeline, native DRC, probing-workcell simulation, instapcb simulation.
adom-circuit — AI-first EDA
aci is the CLI binary. adom-circuit is the repo + wiki page. The tool lets a user (or an AI agent on their behalf) build a PCB by prompting, then watch every step stream into a Hydrogen webview: BOM resolution, library construction, schematic, 3D board, autoroute — all scene-native, all preserved in the final GLB.
The one-sentence mental model
Rust owns parse + geometry + compute (DRC, ERC, gerber, SVG, paste-jet planner). Babylon 8.x in the Hydrogen webview owns the 3D scene. Scene IR JSON streams between them over WebSocket. GLTF2Export produces the final GLB from the live scene — what the user watches being built is what ships.
Core pipeline — aci build --all
cd my-project/
aci build --all # parse → scene IR → drc → svg → gerbers → lib → bom → datasheets → route → probe-sim
aci dev # live Babylon 3D + 3-pane LibView
aci review # one-pass reviewer checklist → artifacts/review.md
aci molecule --owner you # hand off to adom-molecule
Every subcommand is scriptable. Every UI button has a CLI equivalent — see the asci-cli skill.
What aci shares the project as
Per PLAN Part 11 project tree:
board/<name>.kicad_pcb+.kicad_sch+design-rules.tomllib/components/<refdes>/{symbol,footprint,3d,sourcing}.jsondatasheets/<mpn>/datasheet.md— parsed datasheet markdownartifacts/board.glb— clean-board 3D, includes walkthrough + paste-jet animationsartifacts/bom.csv— Mouser-first BOMartifacts/scene-ir.json+build-log.ndjson— fast-load + replayableproject.md— the AI-facing entry point
Non-negotiable rules (see CLAUDE.md in the repo)
- No MCP servers.
acitalks via HTTP + WebSocket per app-creator rule 7b. - Babylon runs only in the Hydrogen webview. No NullEngine. No Playwright. Unattended runs drive the same webview via adom-desktop pup.
- Datasheets come BEFORE supplier lookup — Phase 14 grounds every candidate MPN before Phase 14.5 hits Mouser.
- Mouser is the first-class supplier. DigiKey → JLCPCB are fallbacks.
- Auto-pick smallest non-BGA package with pads ≥ 350 µm (fits the 250 µm solder jet).
- NEVER ALL CAPS in any UI text.
data-tooltip, nottitle="".
When to use this skill
Match on the trigger words above, OR any time the user mentions designing a PCB with AI, the aci CLI, a .kicad_pcb + scene IR flow, solder-jet paste deposition, or the Adom probing workcell.
Sibling skills
- asci-cli — subcommand reference (
aci build,aci dev, etc.) - asci-scene-graph — the stable scene-graph path contract (docs/scene-graph.md)
- asci-live-build — event-bus + streaming UX during
aci build - asci-probing-sim — 100 mm umbilical rule + probing-workcell sim (PLAN Part 14)
- asci-instapcb-process — 26-step manufacturing simulation (PLAN Part 15)
- asci-ralph-loop — visual-test ralph-loop pattern
- asci-publish —
aci share+ wiki publish flow
Further reading
- PLAN.md — 24 parts, 16 phases, the north star
- docs/scene-graph.md
- docs/scene-ir.md
- docs/markdown-tree.md
---
name: adom-circuit
description: AI-first EDA tool for building PCBs — Rust pipeline + Babylon.js 3D viewer in a Hydrogen webview, native KiCad file I/O, native DRC/ERC, tscircuit autorouter, Mouser-first BOM, solder-jet paste deposition, 26-step InstaPCB manufacturing sim, 100mm probing-workcell sim. Binary is `aci`, repo is `adom-circuit`. Use when the user asks to design a PCB via AI, build a board from a prompt, watch a board being built, or when they say words like build a board, design a pcb, ai-first eda, adom circuit, asci, aci build, make a circuit board, dev board, breakout board, iCE40 board, 3D pcb preview with animations, paste-jet simulation, kicad pipeline, native DRC, probing-workcell simulation, instapcb simulation.
---
# adom-circuit — AI-first EDA
`aci` is the CLI binary. `adom-circuit` is the repo + wiki page. The tool lets a user (or an AI agent on their behalf) build a PCB by prompting, then watch every step stream into a Hydrogen webview: BOM resolution, library construction, schematic, 3D board, autoroute — all scene-native, all preserved in the final GLB.
## The one-sentence mental model
Rust owns parse + geometry + compute (DRC, ERC, gerber, SVG, paste-jet planner). Babylon 8.x in the Hydrogen webview owns the 3D scene. Scene IR JSON streams between them over WebSocket. `GLTF2Export` produces the final GLB from the live scene — what the user watches being built *is* what ships.
## Core pipeline — `aci build --all`
```bash
cd my-project/
aci build --all # parse → scene IR → drc → svg → gerbers → lib → bom → datasheets → route → probe-sim
aci dev # live Babylon 3D + 3-pane LibView
aci review # one-pass reviewer checklist → artifacts/review.md
aci molecule --owner you # hand off to adom-molecule
```
Every subcommand is scriptable. Every UI button has a CLI equivalent — see the asci-cli skill.
## What `aci` shares the project as
Per PLAN Part 11 project tree:
- `board/<name>.kicad_pcb` + `.kicad_sch` + `design-rules.toml`
- `lib/components/<refdes>/{symbol,footprint,3d,sourcing}.json`
- `datasheets/<mpn>/datasheet.md` — parsed datasheet markdown
- `artifacts/board.glb` — clean-board 3D, includes walkthrough + paste-jet animations
- `artifacts/bom.csv` — Mouser-first BOM
- `artifacts/scene-ir.json` + `build-log.ndjson` — fast-load + replayable
- `project.md` — the AI-facing entry point
## Non-negotiable rules (see CLAUDE.md in the repo)
- No MCP servers. `aci` talks via HTTP + WebSocket per app-creator rule 7b.
- Babylon runs only in the Hydrogen webview. No NullEngine. No Playwright. Unattended runs drive the same webview via adom-desktop pup.
- Datasheets come BEFORE supplier lookup — Phase 14 grounds every candidate MPN before Phase 14.5 hits Mouser.
- Mouser is the first-class supplier. DigiKey → JLCPCB are fallbacks.
- Auto-pick smallest non-BGA package with pads ≥ 350 µm (fits the 250 µm solder jet).
- NEVER ALL CAPS in any UI text. `data-tooltip`, not `title=""`.
## When to use this skill
Match on the trigger words above, OR any time the user mentions designing a PCB with AI, the `aci` CLI, a `.kicad_pcb` + scene IR flow, solder-jet paste deposition, or the Adom probing workcell.
## Sibling skills
- **asci-cli** — subcommand reference (`aci build`, `aci dev`, etc.)
- **asci-scene-graph** — the stable scene-graph path contract (docs/scene-graph.md)
- **asci-live-build** — event-bus + streaming UX during `aci build`
- **asci-probing-sim** — 100 mm umbilical rule + probing-workcell sim (PLAN Part 14)
- **asci-instapcb-process** — 26-step manufacturing simulation (PLAN Part 15)
- **asci-ralph-loop** — visual-test ralph-loop pattern
- **asci-publish** — `aci share` + wiki publish flow
## Further reading
- [PLAN.md](https://github.com/adom-inc/adom-circuit/blob/main/PLAN.md) — 24 parts, 16 phases, the north star
- [docs/scene-graph.md](https://github.com/adom-inc/adom-circuit/blob/main/docs/scene-graph.md)
- [docs/scene-ir.md](https://github.com/adom-inc/adom-circuit/blob/main/docs/scene-ir.md)
- [docs/markdown-tree.md](https://github.com/adom-inc/adom-circuit/blob/main/docs/markdown-tree.md)