K1 Lightwave: PCB Design & Manufacturing Platform

Status: ✅ FULLY FUNCTIONAL — Ready for hardware design kickoff

---

What This Is

A code-driven PCB design pipeline built into Claude Code. Automates the entire hardware design workflow:

Design Intent → Spec → Schematic → Parts → Layout → Routing → Verification → Fab Package

All steps are:

• ✅ Automated via specialist agents
• ✅ Tracked in Git (reproducible)
• ✅ Validated with ERC/DRC (no surprises)
• ✅ Optimized for JLCPCB manufacturing

Time to manufacturing: 4-6 hours for first design

---

Quick Start (5 Minutes)

1. Prerequisites

# Install KiCad 8/9
brew install kicad  # macOS
# or download from kicad.org

# Verify installation
kicad-cli --version

2. Setup MCP Servers

cd /Users/spectrasynq/Workspace_Management/Software/K1.hardware
python3 mcp/configure_claude.py

# When prompted for credentials:
#   - Leave blank if you don't have API keys
#   - Paste credentials if you do (see SETUP_CREDENTIALS.md)

3. Reload Claude Code

• Close all Claude Code windows
• Reopen Claude Code
• MCP servers now available

4. Start Designing

Ask in Claude Code:

"Design K1 Lightwave PCB: dual ESP32-S3, I2S microphone, WS2812B LEDs, 100×80mm form factor, JLCPCB standard class. Full design workflow."

That's it. The agent handles the rest.

---

What You Get

7 PCB Design Skills

3 Specialist Agents

7 MCP Servers

• mcp-kicad-cli — ERC/DRC/exports
• mcp-nexar — Component search + datasheets
• mcp-lcsc — JLC Assembly pricing
• mcp-freerouting — PCB autorouting
• mcp-kikit — Panelization + V-cuts
• mcp-fabops — Manufacturing pack generation
• mcp-rag — Knowledge retrieval (309 indexed chunks)

Knowledge Base (RAG)

• ESP32-S3 datasheets + hardware design guidelines
• JLCPCB manufacturing rules + DFM guidelines
• Power delivery + impedance + thermal design patterns
• Component selection + sourcing strategies

---

Project Structure

K1.hardware/
├── README.md                          ← You are here
├── QUICKSTART.md                      ← 5-min setup + example workflow
├── SETUP_CREDENTIALS.md               ← API credential setup
├── .claude/
│   ├── K1_PCB_PIPELINE_ARCHITECTURE.md ← Complete architecture docs
│   └── skills/
│       ├── kicad-spec-extractor/
│       ├── kicad-schematic-synthesizer/
│       ├── kicad-part-picker/
│       ├── kicad-pcb-synthesizer/
│       ├── kicad-router-orchestrator/
│       ├── kicad-verification-drf/
│       ├── kicad-publisher-fabpack/
│       └── [10 reference skills: ESP-IDF, FastLED, FreeRTOS, etc.]
├── mcp/
│   ├── configure_claude.py            ← Run this to setup MCP
│   ├── verify-servers.py              ← Check if everything works
│   ├── mcp-kicad-cli/                 ← KiCad automation
│   ├── mcp-nexar/                     ← Component search
│   ├── mcp-lcsc/                      ← JLC pricing
│   ├── mcp-freerouting/               ← PCB routing
│   ├── mcp-kikit/                     ← Panelization
│   ├── mcp-fabops/                    ← Manufacturing
│   ├── mcp-rag/                       ← Knowledge base
│   └── test_rag.py                    ← Test RAG system
├── docs/
│   ├── prd/                           ← Product requirements
│   ├── knowledge/                     ← Design guidelines (RAG indexed)
│   │   ├── vendors/                   ← Espressif, JLCPCB, etc.
│   │   └── tooling/                   ← KiCad, KiKit, LCSC, etc.
│   └── datasheets/                    ← PDF reference docs
├── hardware/
│   └── k1-lightwave/                  ← Design output (will be created)
│       ├── design-spec.yaml           ← Generated design spec
│       ├── kicad/
│       │   ├── k1_schematic.py        ← SKiDL source
│       │   ├── k1_lightwave.kicad_sch ← Generated schematic
│       │   └── k1_lightwave.kicad_pcb ← Generated PCB layout
│       └── fab/
│           ├── gerbers/               ← Manufacturing files
│           ├── k1_lightwave.ipc2581   ← Machine-readable spec
│           ├── k1_lightwave.step      ← 3D model
│           └── k1_lightwave_bom.html  ← Assemb

...