KiCAD-Schematic-Manipulation: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

⚠️ CRITICAL DEVELOPMENT RULES

🚫 Git Commit Policy

NEVER commit changes unless explicitly told by the user.

• Always ask for permission before running git commit
• Only commit when user specifically requests it
• Exception: Only commit automatically when user says "commit this" or similar explicit instruction

📦 Version Management Policy

Always increment PyPI version by patch (0.0.1) unless instructed otherwise.

• Default increment: 0.2.0 → 0.2.1 → 0.2.2
• Only use minor/major increments when user explicitly requests
• Always update both pyproject.toml and src/mcp_kicad_sch_api/__init__.py

📋 Feature Development Policy

Always create a PRD (Product Requirements Document) before implementing features.

• Write a detailed PRD markdown file in the project root
• Include: Problem statement, proposed solution, technical approach, testing plan
• ASK USER FOR FEEDBACK on the PRD before proceeding with implementation
• Do not start coding until user approves the PRD

PRD Template:

# PRD: [Feature Name]

## Problem Statement
[What problem are we solving?]

## Proposed Solution
[High-level approach]

## Technical Implementation
- [Technical details]
- [API changes]
- [Testing approach]

## Success Criteria
[How do we know it works?]

🔄 Required Workflow

1. User requests feature → Write PRD → Ask for user approval
2. User approves PRD → Implement feature → Run tests
3. Implementation complete → Ask user if they want to commit
4. User says commit → Commit with appropriate message
5. User requests release → Increment patch version → Publish to PyPI

Project Overview

KiCAD-Schematic-Manipulation is a Model Context Protocol (MCP) server that provides KiCAD schematic manipulation tools for AI agents. It acts as a bridge between AI systems and KiCAD schematic files, enabling automated circuit design and analysis.