CircuitForge

README excerpt

# CircuitForge

A circuit design agent that catches its own mistakes, fixes them before you see them, and never makes the same one twice.

## The Problem

AI-generated circuits don't work on the first try. Nets are miswired, footprints are wrong, vias violate clearance rules, BOM fields are missing. Every existing tool leaves you to debug this yourself. The workflow becomes: generate, export, open in KiCad, find 30 errors, go back, re-prompt, repeat. You're the error-correction loop.

## What CircuitForge Does Differently

CircuitForge is a self-correcting, self-improving circuit design agent. You describe what you want in plain language. It designs, validates, and fixes the circuit autonomously -- then exports manufacturing-ready files.

**The core loop:**

1. **Generate** -- A multi-model agent pipeline (Claude Opus orchestrates; Sonnet writes tscircuit code; Haiku scouts real JLCPCB parts) produces a circuit from your description.

2. **Validate** -- tscircuit compilation and KiCad analysis (connectivity, ERC, BOM audit) run in parallel against every generation. Not after you export. Every time.

3. **Classify & Repair** -- Every diagnostic is bucketed as `auto_fixable`, `should_demote`, or `must_repair`. The agent makes deterministic decisions about what to retry, what to degrade gracefully, and what needs a fundamentally different approach. Up to 3 bounded attempts with stagnation detection.

4. **Remember** -- Failure patterns are scored with exponential weighted moving