Editing: adom-circuit — AI-first EDA (aci)

Field: AI Skill Technical Reference

---
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)

Cancel

You must be logged into Adom to save. Edits are applied immediately but subject to review.