Skip to the content
6 layers90 × 60 mmEvidence, the printed circuit board in 3D

This plugin puts the someda engine behind three slash commands. In a conversation, Claude writes the circuit as a small JSON plan: real parts with datasheet pinouts, nets, and intent such as "USB-C on the top edge".

Size
90 × 60 mm
Copper layers
6
Thickness
1.6 mm
Parts
132
Nets
114
Pads
563
Tracks, vias
1,708, 470
Pours
4
Routed
Yes
KiCad
KiCad 7 (file 20221018)
Created
19 Oct 2026
Updated
20 Oct 2026

Overview

Evidence is an open-source printed circuit board by kabidey, from the kabidey/someda-claude-plugin repository on GitHub, published under the MIT licence. It is a 6-layer board of 90 × 60 mm with 132 parts on 114 nets, routed with 1,708 tracks and 470 vias.

It is built around the W25Q128JVSIQ, TPS562200DDC and ME6211C18M5G-N, with the USBLC6-2SC6, XC6206P302MR and M2.5 among its other parts. Its parts include 59 capacitors, 43 resistors, 8 connectors, 7 ICs and 3 inductors.

Main components

7

README

README.md

someda for Claude Code

Describe a circuit; get a fab-ready KiCad project with every claim checked.

This plugin puts the someda engine behind three slash commands. In a conversation, Claude writes the circuit as a small JSON plan: real parts with datasheet pinouts, nets, and intent such as "USB-C on the top edge". Never a coordinate. The compiled engine does the rest: schematic, footprints, placement, routing (differential pairs, enforced crosstalk spacing), signal-integrity / stability / thermal audits, KiCad's own ERC and DRC, Gerbers, drill, BOM, a JLCPCB order package and 3D renders. The build ends with six gates; all six pass or the answer is NOT DONE with the failing gate named.

The engine repairs what a plan edit can fix (a misspelled footprint, a missing decoupling capacitor, a regulator short of output capacitance, a connector with no room on its edge) and builds again, so the plan can come from a small model, a large one, or a person.

Install

bash
claude plugin marketplace add kabidey/someda-claude-plugin
claude plugin install someda@someda

On first use the plugin resolves the engine: someda on your PATH, a SOMEDA_BIN override, or the release binary for your platform (Linux x86_64, macOS Apple silicon and Intel, Windows x86_64; other platforms are built from source with cargo). It also installs what a build needs beyond the binary: KiCad's footprint and 3D model libraries (apt on Debian/Ubuntu) and the LCSC/EasyEDA converter in a private virtualenv.

You need KiCad with kicad-cli on your PATH (developed and verified against KiCad 10.0.6). No API key is required: Claude is the planner.

Not using Claude Code? The same release archive the plugin downloads also holds someda-app, a desktop window that does the whole flow with any language model provider (see the engine README).

What a session looks like

text
you:     /pcb-plan a 555 timer blinking an LED at about 1 Hz, 5 V in on a header
claude:  writes plan.json (NE555, timing RC, LED and resistor, 100 nF next to the 555,
         a 2-pin header on the left edge) and shows it for review

you:     /pcb-build 555 LED blinker
claude:  1. schematic written and exported to PDF for your approval
         2. fetch-libs: every footprint and 3D model FOUND or FETCHED (none MISSING)
         3. the engine builds: placement ✓  routed 15 of 15 ✓  audits ✓
            kicad-cli ERC ✓ DRC 0 errors ✓  Gerbers / drill / BOM / JLCPCB package / renders ✓
            export preflight: drc shorts unrouted pours gerbers drill = 6 / 6
         → someda-build/circuit.kicad_pcb, fab/, fab/jlcpcb/, render/, plan.built.json

Those numbers are the engine's quick-start plan (examples/plan_555.json) built with someda 0.7.0 and kicad-cli 10.0.6.

Commands

CommandWhat it does
/pcb-plan <description>Write plan.json following the contract and show it. No build.
/pcb-build <description>Schematic for approval → libraries fetched → build with the engine's repair rounds → honest report of every stage and gate.
/pcb-check <file>The engine's DRC/ERC on an existing .kicad_pcb or .kicad_sch.

The build step in detail:

  1. Schematic first. The engine writes a readable schematic (library symbols, labelled pins) and stops; Claude exports it to PDF and asks you to approve or change the plan.
  2. Libraries. scripts/fetch-libs.py pulls every footprint and 3D model the plan needs that your KiCad libraries lack: KiCad's GitLab repositories, LCSC/EasyEDA by lcsc part number (or mpn, resolved through JLCPCB's parts search), and KiCad zips you downloaded from UltraLibrarian, SnapEDA, Mouser or Digi-Key (--import). Every part ends FOUND, FETCHED (with its source) or MISSING with the plan edit to make. A MISSING name that is only a misspelling is corrected by the engine's first repair round; a part the libraries really lack is never guessed.
  3. Build. someda ai build runs up to SOMEDA_REPAIR_ROUNDS (default 3) repair rounds by itself, printing repair: for what it changed and suggest: with the exact plan edit for what it could not; the plan as built is someda-build/plan.built.json.
  4. Report. Claude reads the stage table and the audits and tells you what passed, what the warnings mean physically, and where the files are. It never claims done when a gate failed.

What the engine does

Placement from real courtyards (mounting holes at their corners, edge connectors rotated so their opening faces the edge and placed on it, parts next to the pins they share, keep-out rings for fine-pitch escapes); routing on JLCPCB rules for 2, 4 or 6 layers with inner planes and per-pad fanouts, escape vias for fine-pitch pins, differential pairs as coupled corridors with matched lengths, 3W/5W crosstalk spacing enforced for every fast net; audits on the routed copper (stray L/C, SWR, unterminated lines, crosstalk re-measured, decoupling loop inductance, regulator and crystal checks, PDN |Z(f)|, junction temperatures, JLCPCB scope); kicad-cli ERC and DRC judged from the report file; Gerbers, drill, position, detailed BOM, JLCPCB order package (Protel-named zip, assembly BOM, CPL with rotation corrections), 3D renders with component bodies. The engine README has the full list and the plan fields.

A real board

examples/sompi-v3s is an Allwinner V3s single-board computer planned this way: 132 parts on 90 × 60 mm, six layers, USB-C, 10/100 Ethernet, microSD, SPI NOR, 40-pin LCD and 24-pin MIPI camera FPCs, audio jack, GPIO header, two bucks and two LDOs. With someda 0.7.0 it routes 187 of 187 connections, couples all seven USB / Ethernet / MIPI pairs within their skew budgets, has 0 crosstalk violations and kicad-cli DRC 0 errors, and passes the six gates. The engine rotated every edge connector from its footprint, moved the audio jack to the bottom edge when the top edge had no slot deep enough, and grew the 1.8 V plane island to reach its capacitors. Its remaining warnings are real and listed (crystal traces of 11–17 mm, one far capacitor, three capacitors beyond the island, board density 147 %).

The unedited outputs of that build (Gerbers, KiCad project, DRC and ERC reports, schematic PDF, renders, BOM, JLCPCB package, checksums) are in examples/sompi-v3s/evidence.

SomPi-V3s isometric render

What "six gates" does not mean

The boards are not simulated and have not been built. Connector pinouts follow conventions that must be checked against the parts you buy; 3D bodies fetched from LCSC are not verified against physical parts; clock-to-data skew across pairs is not enforced; everything is placed on the top side. Read the warnings; they are the engine telling you what it could not make good.

Repository

text
commands/            pcb-plan, pcb-build, pcb-check
skills/someda/       SKILL.md: how Claude plans and runs a build; references/CONTRACT.md: the plan
scripts/             setup-someda.sh (engine + libraries), fetch-libs.py (footprints and 3D models)
examples/sompi-v3s/  the SBC plan, its generator, design notes and build evidence

MIT license · SomTronics

Parts

132
QtyValueFootprintReferences
34100nFCapacitor_SMD:C_0402_1005MetricC1, C2, C10, C11, C12, C13, C14, C16, C17, C18, C19, C20, C21, C22, C24, C25 +18
810uFCapacitor_SMD:C_0603_1608MetricC8, C15, C23, C26, C27, C28, C33, C50
710kResistor_SMD:R_0402_1005MetricR27, R28, R29, R30, R31, R33, R36
422uFCapacitor_SMD:C_0805_2012MetricC43, C44, C47, C48
42k 1%Resistor_SMD:R_0402_1005MetricR1, R2, R3, R4
44.7kResistor_SMD:R_0402_1005MetricR38, R39, R42, R43
451R 1%Resistor_SMD:R_0402_1005MetricR21, R22, R23, R24
4M2.5MountingHole:MountingHole_2.7mm_M2.5H1, H2, H3, H4
310uFCapacitor_SMD:C_0805_2012MetricC40, C42, C46
31kResistor_SMD:R_0402_1005MetricR13, R14, R35
31uFCapacitor_SMD:C_0603_1608MetricC49, C51, C52
333RResistor_SMD:R_0402_1005MetricR32, R34, R37
210k 1%Resistor_SMD:R_0402_1005MetricR18, R20
218pFCapacitor_SMD:C_0402_1005MetricC34, C35
21uFCapacitor_SMD:C_0402_1005MetricC32, C38
2330RResistor_SMD:R_0402_1005MetricR25, R26
24.7uH 3AInductor_SMD:L_Taiyo-Yuden_NR-40xxL1, L2
25.1kResistor_SMD:R_0402_1005MetricR15, R16
26pFCapacitor_SMD:C_0402_1005MetricC36, C37
2TPS562200Package_TO_SOT_SMD:SOT-23-6U2, U3
10RResistor_SMD:R_0402_1005MetricR41
10RResistor_SMD:R_0603_1608MetricR7
1100k 1%Resistor_SMD:R_0402_1005MetricR11
110MResistor_SMD:R_0402_1005MetricR9
110uHInductor_SMD:L_0805_2012MetricL3
11nFCapacitor_SMD:C_0402_1005MetricC39
1200k 1%Resistor_SMD:R_0402_1005MetricR6
122RResistor_SMD:R_0402_1005MetricR40
1240R 1%Resistor_SMD:R_0402_1005MetricR5
124MHzCrystal:Crystal_SMD_3225-4Pin_3.2x2.5mmY1
12A fuseFuse:Fuse_1206_3216MetricF1
13.5mm jackConnector_Audio:Jack_3.5mm_CUI_SJ-3523-SMT_HorizontalJ6
132.768kHzCrystal:Crystal_SMD_3215-2Pin_3.2x1.5mmY2
133.2k 1%Resistor_SMD:R_0402_1005MetricR17
147kResistor_SMD:R_0402_1005MetricR10
15.62k 1%Resistor_SMD:R_0402_1005MetricR19
16.04k 1%Resistor_SMD:R_0402_1005MetricR8
16.8k 1%Resistor_SMD:R_0402_1005MetricR12
1AO3400APackage_TO_SOT_SMD:SOT-23Q1
1Allwinner V3sSomPi:eLQFP-128_14x14mm_P0.4mm_EP5.72x5.72mm_ThermalViasU1
1CAM MIPI 24PConnector_FFC-FPC:Hirose_FH12-24S-0.5SH_1x24-1MP_P0.50mm_HorizontalJ5
1GPIO 2x13Connector_PinHeader_2.54mm:PinHeader_2x13_P2.54mm_VerticalJ7
1KEY1Button_Switch_SMD:SW_SPST_PTS645Sx43SMTR92SW2
1LCD 40P RGBConnector_FFC-FPC:Hirose_FH12-40S-0.5SH_1x40-1MP_P0.50mm_HorizontalJ4
1ME6211C18M5GPackage_TO_SOT_SMD:SOT-23-5U4
1PWR redLED_SMD:LED_0603_1608MetricD1
1RESETButton_Switch_SMD:SW_SPST_PTS645Sx43SMTR92SW1
1RJ45 HR911105AConnector_RJ:RJ45_Hanrun_HR911105A_HorizontalJ2
1STAT greenLED_SMD:LED_0603_1608MetricD2
1UART0 debugConnector_PinHeader_2.54mm:PinHeader_1x03_P2.54mm_VerticalJ8
1USB-C 16PConnector_USB:USB_C_Receptacle_HRO_TYPE-C-31-M-12J1
1USBLC6-2SC6Package_TO_SOT_SMD:SOT-23-6U8
1W25Q128JVSIQPackage_SO:SOIC-8_3.9x4.9mm_P1.27mmU6
1XC6206P302MRPackage_TO_SOT_SMD:SOT-23U5
1microSDConnector_Card:microSD_HC_Hirose_DM3AT-SF-PEJM5J3

Similar boards

  • 6 layers75 × 135.2 mmDumpling Main, the printed circuit board in 3D

    Dumpling Main

    nyuad-space/dumpling

    Modular payload for high-speed logging and benchmarking of COTS sensors, enabling real-world performance data and open sharing.

    370 parts1
  • 4 layers45 × 76 mmPatterngen hw, the printed circuit board in 3D

    Patterngen hw

    pavels/patterngen

    Composite video test pattern generator

    60 partsBSD-2-Clause
  • 4 layers70 × 45 mmFlight computer, the printed circuit board in 3D

    Flight computer

    Ben-Blair/Rocket-Build

    Senior capstone project: demonstrate closed-loop lateral guidance of a high power rocket using forward canards, and handle the canard-wake-on-aft-fin interference problem correctly.

    85 parts
  • 4 layers95 × 95 mmAgentDeck, the printed circuit board in 3D

    AgentDeck

    Brillar0101/agentdeck

    RP2040 macropad for supervising AI coding agents: 13 hot-swap keys with per-key RGB status, encoder, joystick, 4-layer PCB, CircuitPython firmware, printable enclosure

    101 partsMIT
  • 2 layers72 × 36 mmConsole rp, the printed circuit board in 3D

    Console rp

    jmcpheron/pico-quorum

    Several people, several keys, one Safe. Hardware approvals for Safe multisig wallets.

    64 partsMIT
  • 4 layers110 × 80 mmEsp32p4 extreme, the printed circuit board in 3D

    Esp32p4 extreme

    Andreuxxx1977/esp32-p4

    An open-hardware, actively cooled ESP32-P4 board for heavy multimedia work: a 2-lane MIPI camera, a 2-lane MIPI display, USB 2.0 High-Speed, 10/100 Ethernet, UHS-I microSD, 32 MB flash and 32 MB PSRAM.

    234 parts1CERN-OHL-P-2.0
  • 2 layers180 × 100 mmKi pultforsterker main, the printed circuit board in 3D

    Ki pultforsterker main

    SebastianKristo/pult-forsterker

    Ett kort (180 × 100 mm, 2 lag) som erstatter alle modulene, og som i tillegg har USB-delingsswitch, to AUX-innganger som digitaliseres (så alt kan mikses), «smart relé» for strømmen til forsterkerdelen…

    264 partsMIT
  • 4 layers40 × 40 mmScrapHawk FC Main, the printed circuit board in 3D

    ScrapHawk FC Main

    rmingon/ScrapHawk

    An ultra-budget, high-performance drone flight controller powered by the RP2040. Featuring a full 9-axis navigation stack, GPS, dual-stage power filtering, and a dual-core FreeRTOS architecture.

    53 parts1

Questions

How big is the Evidence PCB?

It measures 90 × 60 mm and has 6 copper layers, 1.6 mm thick.

What parts does the Evidence use?

132 parts, built around the W25Q128JVSIQ, TPS562200DDC, ME6211C18M5G-N and USBLC6-2SC6. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Evidence KiCad files?

From the kabidey/someda-claude-plugin repository on GitHub, at the commit this page was made from: the board is examples/sompi-v3s/evidence/kicad/circuit.kicad_pcb and its schematic examples/sompi-v3s/evidence/kicad/circuit.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Evidence design in my own project?

Its repository publishes it under the MIT licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).