agentcad

핵심 루프는 build123d 스크립트를 실행하고 구조화된 JSON을 돌려준다. 세 축의 치수, 부피, 면과 모서리 개수, is_valid 플래그를 받는다. 모델이 깨지면 응답에 오류가 담기고, 흔한 실패 형상에는 고치는 방법까지 제안된다. 모호한 "안 됐다"가 에이전트가 행동할 수 있는 정보로 바뀐다. 단순하지만 효과가 크다.

실행할 때마다 네 각도에서 PNG 미리보기를 렌더링하고, 카메라 위치를 직접 지정할 수도 있다. 렌더링은 2D이며 3D 출력과 다른 키 아래에 있어 섞이지 않는다. 실패한 렌더링이 성공한 빌드를 되돌리는 일은 없다. STEP 파일은 남겨 두고 필요한 뷰만 다시 시도하면 된다.

완성된 모델은 이후 각 도구가 실제로 원하는 형식으로 내보낸다. STEP은 이후 CAD 작업을 위한 정밀 형상을 담고, STL, GLB, OBJ는 3D 프린팅과 웹 뷰어를 담당한다. 성공한 빌드마다 버전이 붙은 STEP 파일도 쓴다. 덮어쓰는 일은 없다.

정적 검사가 문법 오류, 빠진 show_object() 호출, 해석할 수 없는 import를 100밀리초 안에 잡는다. 아무것도 실행되지 않는다. 디스크에 아무것도 쓰이지 않고, 버전 번호도 소모되지 않는다. 수십 번의 시도를 만드는 에이전트에게 실패가 정해진 시도를 건너뛰는 것은 실제 시간을 아낀다.

전용 inspect 명령이 까다로운 형상을 디버깅할 토폴로지 보고서를 만든다. 두 번째 버전부터는 agentcad가 각 결과를 이전 실행과 비교한다. 둘을 합치면 가장 자주 나오는 두 질문에 답한다. 이 솔리드가 왜 무효인가, 그리고 지난번 이후 무엇이 바뀌었는가.

스크립트에 import를 잔뜩 넣을 필요가 없다. build123d 프리미티브, show_object, agentcad 자체의 편집 헬퍼가 미리 주입되므로, 에이전트는 box = Box(10, 20, 5)를 쓰고 넘어간다. import가 적으면 실수도 적다. 상용구가 적다는 것은 에이전트가 오류를 끼워 넣을 곳도 적다는 뜻이다.

agentcad를 프로젝트의 MCP 설정에 추가하면 Claude Code, Cursor 등 호환 에이전트가 CAD 백엔드에 직접 접근한다. agentcad init을 실행하면 운영 안내가 AGENTS.md 블록과 Claude Code 스킬로 저장소에 기록되므로, 에이전트는 매 세션마다 알려 주지 않아도 워크플로를 스스로 챙긴다.