Symbol Agent

1. 한눈에 보기

부품 번호 · 데이터시트 링크 · PDF 에서 KiCad 9 회로 기호를 만듭니다. Claude Code CLI 가 데이터시트의 핀 표를 읽고, 에이전트가 KiCad 규칙에 맞게 그린 뒤 KiCad 로 검증하고, 다른 Claude 가 데이터시트와 대조해 검토합니다.

2. 파이프라인

1. 브리지데이터시트

   올린 PDF · PC 의 PDF · 링크(HTML 이면 안의 PDF 링크를 한 번 따라감)를 씁니다. 없으면 Claude 가 WebSearch/WebFetch 로 제조사 데이터시트를 찾아 후보를 차례로 내려받습니다.

2. Claude추출

   claude -p --json-schema 로 핀 번호 · 이름 · 전기 종류 · 그룹 · 패키지 · 단자 수 · KiCad 풋프린트 · 근거 쪽수를 구조화된 사양(SymbolSpec)으로 받습니다. PDF 는 Read 도구로 필요한 쪽만 읽습니다.

3. 생성기심볼 그리기

   아래 배치 규칙으로 .kicad_sym 을 만듭니다.

4. kicad-cli검증

   규칙 검사 후 kicad-cli sym export svg 로 KiCad 가 실제로 읽고 그리는지 확인하고, 그 그림을 화면에 보여 줍니다.

5. ClaudeAI 교차 검토

   다른 세션의 Claude 가 사양 · 그린 핀 표 · 검사 결과를 데이터시트와 대조합니다. 오류가 있으면 수정한 사양을 돌려주고, 다시 생성 · 검사합니다 (최대 2회).

6. 브리지저장

   통과하면(옵션) 라이브러리 AgentSymbols.kicad_sym 에 합치고, 프로젝트를 지정했으면 AgentParts.kicad_sym 에도 설치합니다. 통과하지 못하면 「확인 필요」로 남겨 사람이 확인 후 저장합니다.

3. 심볼 배치 규칙

1. 전원 입력은 위, 접지(GND · VSS · EP …)는 아래, 입력은 왼쪽, 출력 · 전원 출력 · 오픈 드레인은 오른쪽. 양방향 · 수동 핀은 그룹째로 짧은 쪽에.
2. 같은 기능 그룹(SPI, GPIO 포트 …)은 붙여서, 그룹 사이에는 한 칸 띄웁니다. 그룹 안은 데이터시트 순서.
3. 이름과 종류가 같은 전원 · 수동 핀(GND 4개 등)은 한 자리에 겹쳐 하나만 보이게 합니다 (KiCad 관례, 연결은 모두 됨).
4. 핀 끝은 모두 2.54 mm 격자. 핀 길이는 번호 길이에 따라 2.54 / 3.81 / 5.08 mm.
5. 유닛: 데이터시트가 독립 기능(듀얼 OP-AMP, 쿼드 게이트)이면 Claude 가 유닛을 나누고, 핀이 64개를 넘으면 기능 그룹별로 나누며 전원 핀은 마지막 유닛에 모읍니다.
6. 속성: Reference · Value · Footprint · Datasheet · Description · Manufacturer · MPN · 키워드 · 풋프린트 필터.

4. 검증

5. 설치 · 실행

git clone https://github.com/samcho93/webSymbolAgent
cd webSymbolAgent
start.bat              # 또는 node server/index.js  → http://127.0.0.1:8768/

KiCad 9 · Node.js 18+ · Claude Code CLI(claude 로그인)가 필요합니다. irodmas.com 화면에서 쓸 때는 브라우저의 "로컬 네트워크 접근"을 허용하세요.

6. 사용법

7. Circuit Agent · PCB Studio 연동

프로젝트에 설치한 심볼은 프로젝트 sym-lib-table 에 AgentParts 로 등록되어 Circuit Agent 의 심볼 검색과 circuit.json("symbol": "AgentParts:부품")에서 바로 쓰입니다. Circuit Agent 의 심볼 검색에 결과가 없을 때 「Symbol Agent 로 만들기」로 넘어옵니다. PCB Studio Agent 에서는 「심볼」 탭이며, 통합 Claude 는 pcbstudio symbol create <부품> 로 만듭니다.

8. 브리지 API