circuitron — Copilot Instructions

@function_tool async def search_kicad_libraries(query: str, max_results: int = 50) -> str: """Search KiCad libraries using `skidl.search`.""" # ... implementation using DockerSession ... ` `python

Circuitron is an AI-powered PCB design accelerator that converts natural language requirements into SKiDL scripts, KiCad schematics, and PCB layouts using a multi-agent orchestration pipeline.

The system follows a sophisticated, multi-stage agent workflow defined in circuitron/pipeline.py. It is not a simple linear sequence but includes robust, nested correction loops. • Planner → Plan Editor (optional user feedback loop) • Part Finder → Part Selector • Documentation Agent (gathers context via RAG) • Code Generator • Validation & Correction Loop: • The Validator agent checks the generated code. • If validation fails, the Corrector agent attempts to fix it. This loop continues until the code is valid or a retry limit is reached. • Runtime Check & Correction Loop: • A runtime check is performed in a Docker container. • If it fails, the Runtime Corrector agent attempts a fix. This loop continues until the script runs successfully. • ERC (Electrical Rule Check) & Handling Loop: • The ERC Handler agent runs ERC checks. • If errors or unapproved warnings are found, it attempts to fix them. This loop continues until ERC passes or warnings are explicitly accepted by the agent. • Final Execution: The final, validated script is executed to produce KiCad files. Each agent has specific responsibilities and uses the OpenAI Agents SDK with structured Pydantic models defined in circuitron/models.py.

• Agents (circuitron/agents.py): Specialized OpenAI agents for each pipeline stage. • MCP Server (circuitron/mcp_manager.py): A single, shared connection for RAG documentation, code validation, and hallucination detection. • Tools (circuitron/tools.py): Docker-isolated functions for calculations, KiCad library searches, and ERC checks. • UI (circuitron/ui/app.py): A Rich-based terminal interface for progress tracking and interactive plan editing.