아프니까 개발자다 아프니까 개발자다

서브에이전트를 만드는 방법은 알아도 잘 쓰는 방법은 다르다. 설치했는데 자동으로 호출되지 않거나, 에이전트가 엉뚱한 작업을 하거나, 서로 간섭해서 결과가 망가지는 경우가 생긴다. 이 글은 서브에이전트를 제대로 활용하기 위한 실전 노하우를 정리한다.노하우 1: description은 에이전트의 자동 위임 트리거다이 다이어그램은 사용자가 .py 파일을 편집한 직후 메인 Claude가 어떤 절차로 서브에이전트 자동 호출 여부를 결정하는지 보여준다. 메인은 매 턴마다 "지금 이 상황에 맞는 에이전트가 있는가?"를 묻는데, 그 판단 근거가 바로 등록된 모든 에이전트의 description 필드다. 즉 description은 "이 에이전트가 무슨 일을 하는가"라기보다 "언제 나를 호출해야 하는가"의 트리거 규칙으로..

서브에이전트의 tools 필드에는 기본 도구(Read, Edit, Bash, Grep)를 지정한다. 그런데 이 기본 도구만으로 커버되지 않는 능력이 필요할 때가 있다. 웹 페이지를 직접 가져오거나, 가설을 단계별로 구조화해서 추론하거나, 외부 API를 호출하거나. 이런 새 도구는 MCP 서버에서 온다. 어떤 MCP 서버를 쓸지를 정의하는 파일이 .mcp.json이다.MCP(Model Context Protocol)는 AI 모델이 외부 시스템·도구를 표준 방식으로 호출하는 프로토콜이다 — USB-C처럼 다양한 장치를 하나의 표준 포트로 연결하는 것과 같다..mcp.json이 없을 때 vs 있을 때▲ .mcp.json 없음 — 기본 도구만, 외부 능력 없음▲ .mcp.json 있음 — MCP 도구로 외부 능..