Pcb Design Process Markdown Files — AI skill for Claude Code

PCB Design Process — Markdown Files

These are the exact Markdown files I use to design custom PCBs with an AI coding agent (Claude Code). There are two files, and they work as a pair:

• CLAUDE.md — the project-level instructions file your AI agent reads automatically at the start of every session. Its most important job here is pointing the agent at the process file below and telling it to follow it.
• PCB-DESIGN-PROCESS.md — the actual playbook: a step-by-step process for taking a breadboard-proven Arduino circuit to a fabbed custom PCB, with the AI writing the design files and you verifying at the checkpoints. Every rule in it was earned on real boards that shipped.

New to GitHub?

You don't need an account or any git knowledge to use these files:

1. Click the green Code button at the top of this page.
2. Click Download ZIP.
3. Extract the ZIP — the files inside are everything you need.
4. Follow the setup instructions below.

Or, to grab one file at a time: click the file's name in the list above, then click the **Download raw file** button (the down-arrow icon).

Setup

1. **Copy both files into the root of your project folder** (the folder you open your AI coding agent in).

2. **Name the instructions file for your agent:**

   • Claude Code → keep it named CLAUDE.md.
   • Codex or most other AI CLIs → rename it to AGENTS.md.

   That's the only difference — the contents stay the same. Both tools automatically read their respective file at the start of a session, which is what makes this work without you having to re-explain the process every time. `PCB-DESIGN-PROCESS.md` keeps its name either way.

3. **Edit the instructions file to match *your* setup.** The copy in this folder describes my machine and my projects, so update:

   • The project name and description at the top (yours won't be elegoo-uno-r3-projects).
   • The Environment notes section — my KiCad install path, and the