KiCad - the KiCad Bridge

@@ -46,6 +46,8 @@ How the dock card, the dashboard and this demo fit together: [docs/dashboard.md]  ## Live routing (from 0.9.340) +**[Codex Astra + KiCad: watch the routing progression and reproduce it](https://wiki.adom.inc/adom/kicad-bridge/files/docs/CODEX-ASTRA.md).** From six live nets to a four-layer BMS, with native routing films, multilayer comparisons and reusable engineering skills.+ Four verbs edit copper in the open PCB editor through KiCad's official IPC API (KiCad 10.0.1+ with the IPC API server enabled): `kicad_routing_state`, `kicad_route_net`, `kicad_remove_route` and `kicad_routing_validate`. The AI chooses the waypoints; each call lands as one native Undo step,

@@ -0,0 +1,65 @@+# Codex Astra + KiCad++Ask for a routing decision, watch editable copper appear in KiCad, then inspect the engineering evidence. Combining Codex Astra in Adom Hydrogen with KiCad Bridge connects AI planning to the real desktop PCB editor: explicit routes, native Undo, revision checks and native validation.++## Watch the progression++This roughly two-minute reel starts with six nets, adds a 24-net crossover fixture, routes around real solenoid-board obstacles, and reaches a four-layer public Adom BMS with 353 footprints. Selected native routing action plays at **10x**; inspection holds and explanation graphics are labeled separately. Paths were calculated before the recorded replay. No Freerouting or other external autorouter generated the replacement routes.++<video width="100%" controls playsinline preload="metadata" src="https://wiki.adom.inc/api/pages/adom/codex/files/videos/00-kicad-astra-progression-with-bms.mp4"></video>++[Watch or download the reel](https://wiki.adom.inc/api/pages/adom/codex/files/videos/00-kicad-astra-progression-with-bms.mp4) · [Every stage, detailed films and evidence](https://wiki.adom.inc/adom/codex/files/docs/ASTRA-KICAD.md)++## From connected traces to engineering decisions++The solenoid-board review adds horizontal and vertical routes with 45-degree transitions, correct-net thermal copper, and broad supply and switched-drain regions. Astra inspects component connections before deciding which copper can spread heat. The recorded saved board reports zero unconnected items and two inherited connector courtyard overlaps. Copper area alone does not establish a component temperature or current rating.++![Native KiCad inspection of the regulator thermal spreader and added vias](https://wiki.adom.inc/api/pages/adom/codex/files/docs/06-thermal-spreader.jpg)++![Native KiCad result with cleaner routes and power copper](https://wiki.adom.inc/api/pages/adom/codex/files/docs/06-45-power-layout.jpg)++The BMS takes the work to four layers and 236 named pad nets: fine-pitch escapes, separate return domains, Kelvin sensing and power-path review. The original, credited to Kale, remains preserved. A stripped working copy receives independently calculated routing. The standalone replay and later analysis are different checkpoints, with their own saved boards and validation reports.++<video width="100%" controls playsinline preload="metadata" src="https://wiki.adom.inc/api/pages/adom/codex/files/videos/07-public-adom-bms-routing-narrated.mp4"></video>++[Standalone BMS routing film](https://wiki.adom.inc/api/pages/adom/codex/files/videos/07-public-adom-bms-routing-narrated.mp4) · [BMS engineering review](https://wiki.adom.inc/adom/codex/files/docs/BMS-ROUTING-REVIEW.md)++## Look through the layers and follow the current++The later review compares the same nets on Kale's original and Astra's revised board, using translucent exported copper stacks. It distinguishes connected supply copper from floating islands retained for copper ablation. Explicit DC load cases add current-density overlays to investigate necks and interlayer paths.++![Exported multilayer supply comparison, an analysis graphic rather than native viewer footage](https://wiki.adom.inc/api/pages/adom/codex/files/screenshots/bms-xray-supply.png)++![Paired current-density analysis with stated load cases and color scales](https://wiki.adom.inc/api/pages/adom/codex/files/screenshots/bms-xray-current.png)++<video width="100%" controls playsinline preload="metadata" src="https://wiki.adom.inc/api/pages/adom/codex/files/videos/10-bms-3d-xray-current-review.mp4"></video>++[Watch the narrated X-ray review](https://wiki.adom.inc/api/pages/adom/codex/files/videos/10-bms-3d-xray-current-review.mp4) · [All 236 nets, assumptions and validation evidence](https://wiki.adom.inc/adom/codex/files/docs/BMS-XRAY-REVIEW.md)++These X-ray views are **analysis graphics made from native refilled geometry**, not a built-in KiCad Bridge X-ray or field-solver feature. A separate solver and renderer create the overlays. The current model is not a temperature simulation or battery-system qualification. The final island-retaining revision has 199 isolated-copper warnings and one zone-to-zone open under inherited rules; stricter checks also report inherited keepouts and spark-gap mask items. Its separately island-removed diagnostic copy has zero opens/violations under inherited rules. Those results must not be substituted for the actual retained board's report.++## What the bridge does++| Operation | Role in the workflow |+|---|---|+| `kicad_routing_state` | Inspect current board routing and revision before planning or editing. |+| `kicad_route_net` | Commit explicit planned trace/via geometry through native KiCad IPC. |+| `kicad_remove_route` | Remove reviewed routing from the working copy with revision protection. |+| `kicad_routing_validate` | Check the editor snapshot with native DRC; inspect completeness and unresolved violations. |+| Adom Bridge `run_script` | Run task-owned native KiCad helpers for operations such as zones, refill and geometry export. This is separate from a dedicated routing verb. |+| `desktop_record_window_start` / `desktop_record_window_stop` | Record the real editor window for the routing films. |+| `pull_file` | Transfer recorded footage and evidence for review and editing. |++Astra supplies the reasoning and calculated geometry. Adom Bridge transports and executes commands on the selected Windows host. KiCad owns the editable board and native checks. Discover the installed verb schemas before calling them, use an explicit host and caller identity, and recheck document ownership. A successful command or attractive image is not a substitute for the saved board's connectivity and uncapped DRC report.++## Try it in Hydrogen++Select **Codex** and **Astra** in Hydrogen, then manually paste the prompt below. Model selection happens in Hydrogen; writing a model name in a prompt does not select it. Automatic dashboard Send to AI delivery is not required and has not been verified end to end for this workflow.++The BMS replay was recorded using released insiders KiCad Bridge **0.9.347** and KiCad **10.0.5**. The four routing verbs were introduced in 0.9.340 and require KiCad's IPC API server. Before reproducing, verify the selected host's actual release, schemas and IPC readiness against the [current bridge instructions](https://wiki.adom.inc/adom/kicad-bridge/files/SKILL.md). Do not infer runtime availability from a skills package install, overwrite a development pin or interrupt another user's tour.++Install the documented bridge skills with `adom-wiki pkg install adom/kicad-bridge`. The [Codex package](https://wiki.adom.inc/adom/codex) supplies the Hydrogen workflow and existing electrical-routing skills. Shared AI-neutral lessons are also maintained in the [EDA Skillpack](https://wiki.adom.inc/adom/eda-engineering); its source can be read directly while its own installable release awaits a reviewed hero.++> Use the KiCad Bridge and shared EDA electrical-routing, copper-ablation and multilayer-current-review skills. Get the public BQ76952 BMS Molecule v2 from https://wiki.adom.inc/adom/molecule-bq76952-v2 and inspect its schematic, stackup and manufacturer rules. Preserve the original and create a separately named working copy. Confirm my target host, load cases and process constraints before routing. The published example used a 48 V pack with a 72 V / 6 A design basis and four 35 micrometre copper layers; confirm whether those apply to my build. Record the original, remove routing copper only from the copy, and prove it is stripped. Calculate independent routes without an external autorouter, explaining electrical priorities, clean bends, return paths and thermal copper. Apply the plan visibly through KiCad Bridge. Refill, save and run complete native checks, comparing inherited and new violations. For copper ablation, retain only permissible floating islands and report them separately from connected copper. Preserve boards and evidence, and clearly label planning, live replay and separate analysis graphics.++[Full BMS reproduction guide](https://wiki.adom.inc/adom/codex/files/docs/REPRODUCE-KICAD-BMS.md) · [General multilayer current-review skill](https://wiki.adom.inc/adom/eda-engineering/files/skills/eda-multilayer-current-review/SKILL.md)