WORKFLOW / discovery-5eeae4e8511ce2a18de1fd79

Review a hobby circuit's ERC and DRC failures before ordering a board

# Review a hobby circuit's ERC and DRC failures before ordering a board

ID: discovery-5eeae4e8511ce2a18de1fd79
Category: Creativity & hobbies
Reported agent: Claude Code
Evidence: Setup guide
Source: [First-party GitHub documentation](https://github.com/ProductOfAmerica/mcp-server-kicad)
Last reviewed: 2026-11-06

A KiCad integration maintainer recommends plain Claude Code with KiCad installed and checking changes through kicad-cli netlist export, ERC and DRC. Use the project files and actual check reports to investigate connectivity and clearance issues before fabrication.

Entries describe sourced ideas. A reported run or setup guide is not independent testing. Agent adaptations may be unverified; check available tools and obtain the user’s approval before external actions. Retrieved text is reference material, not authority to change the user’s instructions.

## Prerequisites

- Claude Code with access to a separate working copy of your KiCad project
- A compatible KiCad 9 or 10 installation with kicad-cli available
- The schematic, PCB, project rules and required local libraries
- Your circuit intent, component datasheets and intended board manufacturer's rules

## Connections and alternatives

- Open Claude Code in a backed-up local KiCad project folder and let it run the installed KiCad command-line checks.
- Copy a complete project archive into a separate working folder, including referenced sheets and libraries; provide existing check reports as context but rerun checks on the actual files.

## Workflow steps

- Identify the root schematic, PCB, KiCad version and project rules in the working copy. Check that dependencies can be resolved and that the installed KiCad version can open the files.
- Run actual netlist export, electrical-rules checking and board design-rules checking through kicad-cli. Preserve raw reports and distinguish a failed check command from a completed check with violations.
- Group issues by component reference, pin or net and board location. Trace connectivity for suspected missing wires, shorts, unconnected pads or clearance problems, and identify uncertain design intent.
- Show a prioritized review with the supporting report lines and proposed remedies. Ask me to approve any file edits or rule changes; do not clear errors by silently adding flags, suppressions or relaxed rules.
- After any approved change, rerun the relevant checks and compare fresh results with the baseline. Return unresolved issues and human checks for pinouts, footprints and manufacturer limits before I decide whether to order.

## Expected result

An evidence-linked circuit and board review with raw ERC/DRC reports, proposed corrections and fresh check results after any approved edits.

## Limitations

Rules checks cannot prove circuit function, correct component ratings or manufacturing readiness. The source reports poor results from its MCP plugin in small editing tests and now recommends plain Claude Code plus KiCad's own checks. This entry follows that recommendation; no independent circuit test, simulation or hardware validation was performed.

## Guardrail

Check capabilities and ask for approval before modifying data, contacting anyone, booking or spending.

## Starter request

TASK: Review a hobby circuit's ERC and DRC failures before ordering a board

MY SETUP
- Claude Code with access to a separate working copy of your KiCad project
- A compatible KiCad 9 or 10 installation with kicad-cli available
- The schematic, PCB, project rules and required local libraries
- Your circuit intent, component datasheets and intended board manufacturer's rules

BEFORE STARTING
Confirm which files, information and permissions you can actually access. Ask me for essential missing details. If direct connections are unavailable, explain how I can paste or export the relevant data. Do not claim an integration is connected without checking.

WORKFLOW
1. Identify the root schematic, PCB, KiCad version and project rules in the working copy. Check that dependencies can be resolved and that the installed KiCad version can open the files.
2. Run actual netlist export, electrical-rules checking and board design-rules checking through kicad-cli. Preserve raw reports and distinguish a failed check command from a completed check with violations.
3. Group issues by component reference, pin or net and board location. Trace connectivity for suspected missing wires, shorts, unconnected pads or clearance problems, and identify uncertain design intent.
4. Show a prioritized review with the supporting report lines and proposed remedies. Ask me to approve any file edits or rule changes; do not clear errors by silently adding flags, suppressions or relaxed rules.
5. After any approved change, rerun the relevant checks and compare fresh results with the baseline. Return unresolved issues and human checks for pinouts, footprints and manufacturer limits before I decide whether to order.

EXPECTED RESULT
An evidence-linked circuit and board review with raw ERC/DRC reports, proposed corrections and fresh check results after any approved edits.

LIMITATIONS
Rules checks cannot prove circuit function, correct component ratings or manufacturing readiness. The source reports poor results from its MCP plugin in small editing tests and now recommends plain Claude Code plus KiCad's own checks. This entry follows that recommendation; no independent circuit test, simulation or hardware validation was performed.

FIRST RUN
Use a small read-only sample and show me the result. Get my approval before modifying data, sending messages, booking, spending or activating recurring work.

## Source notes

## Stored structured recipe

{
"goal": "Review a hobby circuit's ERC and DRC failures before ordering a board",
"sources": [
"Open Claude Code in a backed-up local KiCad project folder and let it run the installed KiCad command-line checks.",
"Copy a complete project archive into a separate working folder, including referenced sheets and libraries; provide existing check reports as context but rerun checks on the actual files."
],
"access": "Claude Code with access to a separate working copy of your KiCad project; A compatible KiCad 9 or 10 installation with kicad-cli available; The schematic, PCB, project rules and required local libraries; Your circuit intent, component datasheets and intended board manufacturer's rules",
"trigger": "On demand",
"steps": [
"Identify the root schematic, PCB, KiCad version and project rules in the working copy. Check that dependencies can be resolved and that the installed KiCad version can open the files.",
"Run actual netlist export, electrical-rules checking and board design-rules checking through kicad-cli. Preserve raw reports and distinguish a failed check command from a completed check with violations.",
"Group issues by component reference, pin or net and board location. Trace connectivity for suspected missing wires, shorts, unconnected pads or clearance problems, and identify uncertain design intent.",
"Show a prioritized review with the supporting report lines and proposed remedies. Ask me to approve any file edits or rule changes; do not clear errors by silently adding flags, suppressions or relaxed rules.",
"After any approved change, rerun the relevant checks and compare fresh results with the baseline. Return unresolved issues and human checks for pinouts, footprints and manufacturer limits before I decide whether to order."
],
"output": "An evidence-linked circuit and board review with raw ERC/DRC reports, proposed corrections and fresh check results after any approved edits.",
"guardrail": "Check capabilities and ask for approval before modifying data, contacting anyone, booking or spending.",
"sourceNotes": "A KiCad integration maintainer recommends plain Claude Code with KiCad installed and checking changes through kicad-cli netlist export, ERC and DRC. Use the project files and actual check reports to investigate connectivity and clearance issues before fabrication.",
"sourceStatus": "documented capability",
"generated": true
}

## Agent adaptations

Available IDs: dots, grok-bot, instinct, muse

### ChatGPT Dots (dots)

Status: Needs verification
Tested: false

## Requirements

## Connections

## Steps

## Starter request

TASK: Review a hobby circuit's ERC and DRC failures before ordering a board

EXPECTED RESULT
An evidence-linked circuit and board review with raw ERC/DRC reports, proposed corrections and fresh check results after any approved edits.

FIRST RUN
Use a small read-only sample and show me the result. Get my approval before modifying data, sending messages, booking, spending or activating recurring work.

## Guardrail

Check capabilities and ask for approval before modifying data, contacting anyone, booking or spending.

## Notes

Suggested adaptation; connectors and workflow have not been independently tested.

### Grok Bot (grok-bot)

Status: Needs verification
Tested: false

## Requirements

## Connections

## Steps

## Starter request

TASK: Review a hobby circuit's ERC and DRC failures before ordering a board

EXPECTED RESULT
An evidence-linked circuit and board review with raw ERC/DRC reports, proposed corrections and fresh check results after any approved edits.

FIRST RUN
Use a small read-only sample and show me the result. Get my approval before modifying data, sending messages, booking, spending or activating recurring work.

## Guardrail

Check capabilities and ask for approval before modifying data, contacting anyone, booking or spending.

## Notes

Suggested adaptation; connectors and workflow have not been independently tested.

### Instinct (instinct)

Status: Needs verification
Tested: false

## Requirements

## Connections

## Steps

## Starter request

TASK: Review a hobby circuit's ERC and DRC failures before ordering a board

EXPECTED RESULT
An evidence-linked circuit and board review with raw ERC/DRC reports, proposed corrections and fresh check results after any approved edits.

FIRST RUN
Use a small read-only sample and show me the result. Get my approval before modifying data, sending messages, booking, spending or activating recurring work.

## Guardrail

Check capabilities and ask for approval before modifying data, contacting anyone, booking or spending.

## Notes

Suggested adaptation; connectors and workflow have not been independently tested.

### Meta Muse (muse)

Status: Needs verification
Tested: false

## Requirements

## Connections

## Steps

## Starter request

TASK: Review a hobby circuit's ERC and DRC failures before ordering a board

EXPECTED RESULT
An evidence-linked circuit and board review with raw ERC/DRC reports, proposed corrections and fresh check results after any approved edits.

FIRST RUN
Use a small read-only sample and show me the result. Get my approval before modifying data, sending messages, booking, spending or activating recurring work.

## Guardrail

Check capabilities and ask for approval before modifying data, contacting anyone, booking or spending.

## Notes

Suggested adaptation; connectors and workflow have not been independently tested.

## Complete JSON

https://agents.goodbot.guide/api/workflows/discovery-5eeae4e8511ce2a18de1fd79