
Candidate filled profile
misko/prompt2device
The separate vNext PCB skill and orchestrator package is available alongside the reference workflow below; existing projects keep their accepted toolchain until an explicit migration.

The separate vNext PCB skill and orchestrator package is available alongside the reference workflow below; existing projects keep their accepted toolchain until an explicit migration.
R1b is an open-source printed circuit board by misko, from the misko/prompt2device repository on GitHub, published under the MIT licence. It is a 4-layer board of 185 × 120 mm with 182 parts on 143 nets, routed with 478 tracks and 33 vias.
It is built around the USBLC6-2SC6, AMS1117-3.3 and DIP05-1A72-12L, with the PESD5V0S1BA among its other parts. Its parts include 32 resistors, 30 capacitors, 16 switches, 9 ICs and 7 connectors.
The separate vNext PCB skill and orchestrator package is available alongside the reference workflow below; existing projects keep their accepted toolchain until an explicit migration.
The Crow carrier + pod public design package provides native designs and fabrication exports for the 5-carrier/10-pod prototype batch. It is a subset of the local sealed release, not order authorization.
Prompt to device: give an agent a plain-language hardware brief, work through explicit design, review, and physical-test cycles, and finish with the artifacts needed to manufacture the device—not merely a plausible CAD image.
/pcb-design 3S LiPo input → 4× USB-A outputs at 5 V / 1.5 A each + 1× USB-C output at 5 V / 5 A.These two projects show the path from a plain-English request to electrical
CAD, mechanical CAD, and fabricated hardware. The prompt cells preserve the
compact original wording; the links retain the corresponding design-lineage
records. Photographs are bench evidence, not production-qualification claims.
Exact provenance and claim limits are in
fabricated-examples.md.
| Pluto eight-way fast switch | 3S LiPo USB power board | |
|---|---|---|
| Prompt | “we want a high speed 8 antenna switching board that can be programmed by the rpi4 and run with a pluto+” | “Please from scratch start a new project, and lets design a board that takes 3S lipo XT60 power as input , and outputs 3 x USB A ports (2.5A max) and 1 x USB C port (6A max).” |
| PCB rendering | ![]() | ![]() |
| Enclosure rendering | ![]() | ![]() |
| Fabricated board | ![]() | ![]() |
| Board in enclosure | ![]() | ![]() |
| Bench setup | ![]() | ![]() |
pluto-rx2-8way-v5 is the fabricated
eight-way RF switch board. Its immutable PCB design archive is
v0.2.1-2026-08-14,
with a sealed
3D PCB render,
and its independently versioned
v0.8.0-2026-08-28 enclosure
has a corresponding
installed-assembly render.
That enclosure remains an honest INCOMPLETE candidate pending sliced and
printed fit, retention, connector-service, and thermal tests.
The PCB archive itself predates fabrication and still records
DO-NOT-ORDER; RF first-article measurements remain open.
The current human-readable engineering study is
RF isolation, leakage paths, and a v6 mitigation strategy.
usb-hub-3s-v3 is the closest existing hardware
to the quick-start brief: three USB-A outputs and one USB-C output rather than
four USB-A outputs. Its latest sealed and fabricated archive is
v1.12-2026-07-28.
The bring-up journal
records physical v1.12 boards and the replacement assembly's successful
no-load regulation checks; full load, transient, and thermal qualification is
still open.
The exact v1.12 board also has an independently versioned
v0.4.0-2026-08-28 enclosure
with a corresponding
installed-assembly render.
Its authored source and replay instructions
remain mutable, while the release is an immutable INCOMPLETE candidate:
structural and collision screens pass, but printed fit, connector service,
retention, and thermal evidence remain open.
plain-language brief
→ fact locks and architecture
→ schematic, placement, routing, and enclosure development
↺ independent review, correction, regeneration, and measurement
→ sealed fabrication and mechanical artifacts
→ first article, physical findings, and the next development cycleToday the governed output can include:
01_docs/reports/.The pipeline already uses board-level CAD/assembly twins as verification instruments. Governed firmware releases and an integrated product-level digital twin are forward work, tracked by IMP-234 and IMP-236.
prompt2device is a code-first prompt-to-device engineering system. It turns a
user brief into generated KiCad source, bounded routing candidates,
independently graded fabrication evidence, immutable releases, printable
enclosures, and measured first-article records.
The product is the workflow under skills/. Boards under
projects/ are its active applications; sealed release folders
are immutable evidence, not templates to copy.
Clone the repository, create a branch, and save the user's original request as a UTF-8 text file:
git clone https://github.com/misko/prompt2device.git
cd prompt2device
git switch -c codex/my-boardCreate the governed project scaffold and choose its capability profile:
python3 skills/pcb-design/scripts/commission_project.py my-board \
--brief-file /path/to/original-brief.txt \
--signal-integrity ordinary \
--assembly jlcpcb \
--firmware forbidden \
--target designUse high_speed_digital for USB and similar controlled digital links. Use
rf only when the board intentionally carries RF/microwave signals. Add
--foreign-mating when the floorplan consumes geometry from third-party
hardware. Run the command with --help for enclosure and target options.
Here --assembly jlcpcb selects the populated JLCPCB PCBA evidence path, not
merely bare-board fabrication.
The command reports PCB-SCAFFOLD OK and leaves PCB-COMMISSION explicitly
INCOMPLETE. It preserves the prompt and creates an executable commission
hold; it does not accept requirements, adopt the seeded schema examples, or
run a board producer.
Inspect the selected lifecycle before spending engineering time:
python3 skills/pcb-design/scripts/skill_reference_router.py \
--profile projects/my-board/01_docs/capability-profile.json \
--at-stage PCB-COMMISSION \
--jsonThen give Codex this instruction:
Read and follow skills/pcb-design/SKILL.md for projects/my-board. Preserve the
original brief, close the commission fact locks, and stop at the first evidence
or operator checkpoint. Do not create firmware unless the brief explicitly
asks.Do not run rebuild_all.sh yet. The scaffold contains visible schema examples
and 01_docs/COMMISSIONING-HOLD.md; both rebuild conductors refuse to run until
the commission boundary is reviewed and that marker is deliberately removed.
Start with skills/pcb-design/SKILL.md. Its
canonical lifecycle and runnable command map is
execution-graph.md.
The repository deliberately separates three layers:
capability profile
-> disclosure graph (what stages/references are selected)
-> project conductor (what bounded commands actually run)
-> owning gates (what exact subjects passed)
-> review/seal/publication/physical claimsprojects/<name>/03_src/rebuild_all.sh is the full source/schematic
conductor. It intentionally pauses at review and operator checkpoints.rebuild_reuse.sh is the deterministic route-authority replay when the
schematic is unchanged; route.yaml selects the authenticated source.route.yaml.The declarative lifecycle is:
commission -> architecture -> sourcing
-> schematic -> placement -> routing -> layout seal
-> fabrication -> assembly verification
-> release review -> release seal
-> publication | first article -> productionRF context/source/realized/fabrication stages and foreign-mating import are conditional branches. High-speed digital composes inside the ordinary stages. Enclosures have an implemented parallel INCOMPLETE-candidate release stream and may bind an unchanged PCB release without resealing it. Higher readiness still requires the enclosure skill's recomputable CAD and physical evidence. Firmware is currently an explicit handoff, not a governed release stream; IMP-234 tracks that missing boundary.
| Skill | Owns |
|---|---|
pcb-design | Commission, lifecycle composition, backtracking, reviews, release seal, publication, first article. |
kicad-pcb | TSX/KiCad schematic conversion, netlist/parity, placement, geometry, routing, DRC, SI/RF realization. |
jlcpcb-fab | Gerber/drill/BOM/CPL, stock/population/rotation, JLC CAD twin, manufacturer staging, bring-up cards. |
pcb-enclosure | Mechanical commission, PCB interface binding, independent fasteners, motion/clearance, mesh/physical evidence, enclosure releases. |
shopping-list | Provenance-bound purchase lists for self-supplied parts. |
Authority is singular. A skill links to another owner's procedure rather than
copying it. Project contracts.md files own exact artifact membership. Script
--help text owns exact flags. improvements.md tracks
work and rationale but never overrides an executable gate or accepted ADR.
| Path | Purpose |
|---|---|
skills/ | Reusable workflow, references, tools, and project templates. |
projects/ | Active boards, including manufactured and still-evolving designs. |
archived_projects/ | Retired scaffolds and frozen regression/history units. |
docs/ | Documentation index, accepted ADRs, measured proof, and historical context. |
tests/ | Clean and known-bad fixtures proving gates can both pass and fail. |
external_hardware/ | Measured/cited facts about foreign devices this repo must mate with. |
improvements.md | Forward work registry and retained improvement history. |
See docs/README.md for the documentation authority map.
The board is generated from committed human-owned source:
kicad-cli owns headless
ERC/DRC/netlist/export checks.04_kicad/ is a mutable current snapshot and is never hand-source
authority. Immutable history lives under release streams.This makes design changes diffable and rebuildable. It also means a generator defect can become a physical defect, so freshness, parity, nonzero coverage, registered models, and independent review are first-class gates.
A release is an immutable reviewed candidate archive. It is not automatically
an order event. A design can be electrically sound and sealed while remaining
DO-NOT-ORDER because stock, uploader selections, physical fit, or first-
article evidence is owed.
PCB and enclosure versions are independent streams. Current enclosure release
tooling publishes immutable INCOMPLETE candidates bound to one exact PCB
release without forcing that PCB to be resealed; it does not yet publish a
higher readiness claim from caller-supplied scope status.
A future firmware stream, exact product lock, and integrated product-level
digital twin remain tracked work, not current release authority.
Core documentation and planning use normal Python 3. KiCad operations require
the KiCad-bundled Python where import pcbnew succeeds plus kicad-cli.
TSX generation requires the pinned tscircuit/Bun environment. Fresh routing
requires the configured KiCadRoutingTools installation; replaying a selected
authenticated route authority does not.
Python entry points expose --help; shell-conductor forms are documented in
the execution graph. Use the owning current command rather than copying an old
invocation from a project journal.
At minimum:
python3 skills/pcb-design/scripts/skill_authority_check.py
python3 tests/t1_skill_progressive_disclosure.py
python3 tests/t1_pcb_documentation.py
python3 scripts/contracts_audit.py --walk --root skills/pcb-designRun the domain suites affected by the change, then commit at a green boundary.
Except where otherwise noted, all original content in this repository is licensed under the MIT License. This includes software, documentation, prompts, schematics, PCB layouts, mechanical CAD files, and generated design artifacts.
Third-party materials remain subject to their respective copyright and license terms and are not relicensed by this repository.
See third-party notices for material provenance and contribution guidelines for new submissions.
| Qty | Value | Footprint | References |
|---|---|---|---|
| 16 | DIP05-1A72-12L | cookhub:Relay_StandexDIP_1A_pinout12 | K1, K2, K3, K4, K5, K6, K7, K8, K9, K10, K11, K12, K13, K14, K15, K16 |
| 6 | MountingHole_3.2mm_M3 | MountingHole:MountingHole_3.2mm_M3 | H1, H2, H3, H4, H5, H6 |
| 5 | PESD5V0S1BA | Diode_SMD:D_SOD-323 | D3, D4, D5, D6, D7 |
| 3 | 100n RC | Capacitor_SMD:C_0603_1608Metric | C51, C52, C53 |
| 3 | 10k 1% ref | Resistor_SMD:R_0603_1608Metric | R51, R52, R53 |
| 3 | 1k RC | Resistor_SMD:R_0603_1608Metric | R54, R55, R56 |
| 3 | USBLC6-2SC6 | Package_TO_SOT_SMD:SOT-23-6 | U13, U14, U15 |
| 2 | 22u 3V3 | Capacitor_SMD:C_0805_2012Metric | C2, C3 |
| 2 | 22u 5VP | Capacitor_SMD:C_0603_1608Metric | C4, C5 |
| 2 | TP GND | TestPoint:TestPoint_Pad_D1.5mm | TP4, TP5 |
| 1 | 100R TC+ | Resistor_SMD:R_0603_1608Metric | R61 |
| 1 | 100R TC- | Resistor_SMD:R_0603_1608Metric | R62 |
| 1 | 100k Q3 gate | Resistor_SMD:R_0603_1608Metric | R12 |
| 1 | 100n 3V3A | Capacitor_SMD:C_0603_1608Metric | C7 |
| 1 | 100n RELAY_5V | Capacitor_SMD:C_0603_1608Metric | C9 |
| 1 | 100n TC diff | Capacitor_SMD:C_0603_1608Metric | C61 |
| 1 | 100n U1 | Capacitor_SMD:C_0603_1608Metric | C18 |
| 1 | 100n U11 | Capacitor_SMD:C_0603_1608Metric | C17 |
| 1 | 100n U13 | Capacitor_SMD:C_0603_1608Metric | C20 |
| 1 | 100n U14 | Capacitor_SMD:C_0603_1608Metric | C21 |
| 1 | 100n U15 | Capacitor_SMD:C_0603_1608Metric | C22 |
| 1 | 100n U3 | Capacitor_SMD:C_0603_1608Metric | C12 |
| 1 | 100n U4 | Capacitor_SMD:C_0603_1608Metric | C13 |
| 1 | 100n U7 | Capacitor_SMD:C_0603_1608Metric | C14 |
| 1 | 100n U8 | Capacitor_SMD:C_0603_1608Metric | C15 |
| 1 | 100n U9 | Capacitor_SMD:C_0603_1608Metric | C16 |
| 1 | 100n door RC | Capacitor_SMD:C_0603_1608Metric | C33 |
| 1 | 100n estop RC | Capacitor_SMD:C_0603_1608Metric | C31 |
| 1 | 10k /OE pu | Resistor_SMD:R_0603_1608Metric | R21 |
| 1 | 10k RLY_EN pd | Resistor_SMD:R_0603_1608Metric | R22 |
| 1 | 10k bleed | Resistor_SMD:R_0603_1608Metric | R25 |
| 1 | 10k door RC | Resistor_SMD:R_0603_1608Metric | R34 |
| 1 | 10k estop RC | Resistor_SMD:R_0603_1608Metric | R32 |
| 1 | 10n TC+ cm | Capacitor_SMD:C_0603_1608Metric | C62 |
| 1 | 10n TC- cm | Capacitor_SMD:C_0603_1608Metric | C63 |
| 1 | 10u 3V3A | Capacitor_SMD:C_0805_2012Metric | C6 |
| 1 | 10u LDO in | Capacitor_SMD:C_0805_2012Metric | C1 |
| 1 | 10u RELAY_5V | Capacitor_SMD:C_0805_2012Metric | C8 |
| 1 | 10u U1 | Capacitor_SMD:C_0805_2012Metric | C19 |
| 1 | 10u VSYS | Capacitor_SMD:C_0805_2012Metric | C10 |
| 1 | 1k Q2 gate | Resistor_SMD:R_0603_1608Metric | R24 |
| 1 | 1u X7R WD | Capacitor_SMD:C_0603_1608Metric | C11 |
| 1 | 220u 16V bulk | Capacitor_SMD:CP_Elec_6.3x7.7 | CE1 |
| 1 | 2N7002 | Package_TO_SOT_SMD:SOT-23 | Q2 |
| 1 | 2k2 SCL0 pu | Resistor_SMD:R_0603_1608Metric | R72 |
| 1 | 2k2 SCL1 pu | Resistor_SMD:R_0603_1608Metric | R76 |
| 1 | 2k2 SDA0 pu | Resistor_SMD:R_0603_1608Metric | R71 |
| 1 | 2k2 SDA1 pu | Resistor_SMD:R_0603_1608Metric | R75 |
| 1 | 330R opto LED | Resistor_SMD:R_0603_1608Metric | R26 |
| 1 | 33R SCL0 | Resistor_SMD:R_0603_1608Metric | R42 |
| 1 | 33R SCL1 | Resistor_SMD:R_0603_1608Metric | R44 |
| 1 | 33R SDA0 | Resistor_SMD:R_0603_1608Metric | R41 |
| 1 | 33R SDA1 | Resistor_SMD:R_0603_1608Metric | R43 |
| 1 | 390k 1% WD | Resistor_SMD:R_0603_1608Metric | R11 |
| 1 | 3k3 door pu | Resistor_SMD:R_0603_1608Metric | R33 |
| 1 | 3k3 estop pu | Resistor_SMD:R_0603_1608Metric | R31 |
| 1 | 47k Q1 pu | Resistor_SMD:R_0603_1608Metric | R23 |
| 1 | 4k7 SCL0 pu | Resistor_SMD:R_0603_1608Metric | R74 |
| 1 | 4k7 SCL1 pu | Resistor_SMD:R_0603_1608Metric | R78 |
| 1 | 4k7 SDA0 pu | Resistor_SMD:R_0603_1608Metric | R73 |
| 1 | 4k7 SDA1 pu | Resistor_SMD:R_0603_1608Metric | R77 |
| 1 | 600R ferrite | Inductor_SMD:L_0805_2012Metric | FB1 |
| 1 | 74HC14 E-stop | Package_SO:SOIC-14_3.9x8.7mm_P1.27mm | U11 |
| 1 | 74HC595 #1 | Package_SO:SOIC-16_3.9x9.9mm_P1.27mm | U3 |
| 1 | 74HC595 #2 | Package_SO:SOIC-16_3.9x9.9mm_P1.27mm | U4 |
| 1 | 74LVC1G00 /OE | Package_TO_SOT_SMD:SOT-353_SC-70-5 | U8 |
| 1 | 74LVC1G11 AND3 | Package_TO_SOT_SMD:SOT-23-6 | U9 |
| 1 | AMS1117-3.3 | Package_TO_SOT_SMD:SOT-223-3_TabPin2 | U12 |
| 1 | AO3401A hi-side | Package_TO_SOT_SMD:SOT-23 | Q1 |
| 1 | AO3401A rev-prot | Package_TO_SOT_SMD:SOT-23 | Q3 |
| 1 | CONTACTOR 30V | cookhub:TerminalBlock_KF350_2P | J10 |
| 1 | DOOR NC+EOL | Connector_JST:JST_XH_B3B-XH-A_1x03_P2.50mm_Vertical | J7 |
| 1 | DOOR->ADC2 opt | Jumper:SolderJumper-2_P1.3mm_Open_Pad1.0x1.5mm | SJ1 |
| 1 | E-STOP NC | Connector_JST:JST_XH_B2B-XH-A_1x02_P2.50mm_Vertical | J8 |
| 1 | ENCODER DNP | Connector_JST:JST_XH_B5B-XH-A_1x05_P2.50mm_Vertical | J12 |
| 1 | EXT 5V 2A | Connector_BarrelJack:BarrelJack_CUI_PJ-063AH_Horizontal | J1 |
| 1 | HALL 3V3 opt | Connector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_Vertical | JP5 |
| 1 | I2C0 MLX+SHT45 | Connector_JST:JST_XH_B4B-XH-A_1x04_P2.50mm_Vertical | J3 |
| 1 | I2C0 PU 2k2|4k7 | Connector_PinHeader_2.54mm:PinHeader_1x03_P2.54mm_Vertical | JP1 |
| 1 | I2C1 EXHAUST SHT45 | Connector_JST:JST_XH_B4B-XH-A_1x04_P2.50mm_Vertical | J4 |
The 115 most common of 182 parts.

misko/prompt2device
The separate vNext PCB skill and orchestrator package is available alongside the reference workflow below; existing projects keep their accepted toolchain until an explicit migration.

misko/prompt2device
The separate vNext PCB skill and orchestrator package is available alongside the reference workflow below; existing projects keep their accepted toolchain until an explicit migration.

misko/prompt2device
The separate vNext PCB skill and orchestrator package is available alongside the reference workflow below; existing projects keep their accepted toolchain until an explicit migration.

misko/prompt2device
The separate vNext PCB skill and orchestrator package is available alongside the reference workflow below; existing projects keep their accepted toolchain until an explicit migration.

misko/prompt2device
The separate vNext PCB skill and orchestrator package is available alongside the reference workflow below; existing projects keep their accepted toolchain until an explicit migration.

misko/prompt2device
The separate vNext PCB skill and orchestrator package is available alongside the reference workflow below; existing projects keep their accepted toolchain until an explicit migration.

misko/prompt2device
The separate vNext PCB skill and orchestrator package is available alongside the reference workflow below; existing projects keep their accepted toolchain until an explicit migration.

misko/prompt2device
The separate vNext PCB skill and orchestrator package is available alongside the reference workflow below; existing projects keep their accepted toolchain until an explicit migration.

misko/prompt2device
The separate vNext PCB skill and orchestrator package is available alongside the reference workflow below; existing projects keep their accepted toolchain until an explicit migration.

misko/prompt2device
The separate vNext PCB skill and orchestrator package is available alongside the reference workflow below; existing projects keep their accepted toolchain until an explicit migration.

misko/prompt2device
The separate vNext PCB skill and orchestrator package is available alongside the reference workflow below; existing projects keep their accepted toolchain until an explicit migration.

misko/prompt2device
The separate vNext PCB skill and orchestrator package is available alongside the reference workflow below; existing projects keep their accepted toolchain until an explicit migration.




jadenrhee/wigglecam-controller
RP2040 co-processor board for a 4-lens wigglegram camera: constant-current flash, controls, battery telemetry, Pi 5 I2C interface. 4-layer, DRC-clean, fab-ready.

nathanfraske/CEC-Platform
ONE board file, kept current by the wave (owner directive 2026-07-25: "the current best should be placed into a candidate folder per board and kept current with only one board ideally so we have a reference").

rwrife/quiet-trace
USB-powered ESP32-S3 ambient sound-level logger for home offices and shared rooms that keeps only privacy-preserving loudness summaries and serves a local history dashboard—never raw audio.

SpaceCadetJ/LoRa-Autonomous-Boat
An embedded-systems project spanning STM32 firmware, LoRa communication, PCB reconstruction and a documented V2 redesign.

It measures 185 × 120 mm and has 4 copper layers, 1.6 mm thick.
182 parts, built around the USBLC6-2SC6, AMS1117-3.3, DIP05-1A72-12L and PESD5V0S1BA. 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.
From the misko/prompt2device repository on GitHub, at the commit this page was made from: the board is archived_projects/cook-hub/06_build/route/r1b.kicad_pcb. PCBKit opens the board in the browser, with nothing to install.
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).