Runs KiCad DRC/ERC checks, exports gerbers and BOM, and generates a structured findings report. Use when reviewing PCB designs, running design rule checks, or preparing manufacturing outputs.
Target: $ARGUMENTS
Run KiCad design rule checks and export manufacturing outputs.
Read these before proceeding:
references/kicad-cli-reference.md — DRC/ERC commands, JSON output schema, gerber/BOM exportDetect kicad-cli — Verify kicad-cli is available, report version
Find project files — Glob for *.kicad_pro, *.kicad_sch, *.kicad_pcb
Run ERC on schematic:
kicad-cli sch erc --output erc-report.json --format json <schematic.kicad_sch>
Run DRC on PCB:
kicad-cli pcb drc --output drc-report.json --format json <pcb.kicad_pcb>
Parse JSON reports — Categorize violations by severity (error/warning/exclusion)
If clean (no errors), export manufacturing outputs:
kicad-cli pcb export gerbers --output gerbers/ <pcb.kicad_pcb>kicad-cli pcb export drill --output gerbers/ <pcb.kicad_pcb>kicad-cli sch export bom --output bom.csv <schematic.kicad_sch>Generate findings report at docs/pcb-audit-report.md
# PCB Audit Report: <Project Name>
## Tool Version
kicad-cli <version>
## ERC Results
- Errors: N
- Warnings: N
- <violation description> @ <sheet:component>
## DRC Results
- Errors: N
- Warnings: N
- <violation description> @ <coordinates>
## Manufacturing Outputs
- [ ] Gerbers exported to gerbers/
- [ ] Drill files exported to gerbers/
- [ ] BOM exported to bom.csv
## Recommendations
...