지난 한 주 동안 실제로 작동하는 Claude Code 서브 에이전트(sub-agents) '크루(crew)'를 구축하는 데 시간을 보냈습니다. 작업을 범위화하는 리드(lead), 빌더(builder), QA 에이전트, 그리고 보안 중심 에이전트가 제가 모든 프롬프트를 마이크로매니징하는 대신 공유된 사양/작업 파일(spec/task files)을 통해 협업하는 구조입니다. 시작할 때 예상하지 못했던 몇 가지 솔직한 문제들이 있었습니다. API 키가 클라이언트 측 코드(client-side code)로 유출될 뻔했습니다. 부주의해서가 아니라, 채팅 UI를 Claude의 API에 연결할 때 빠지기 쉬운 함정입니다. 결국 키가 브라우저에 절대 닿지 않도록 모든 것을 서버 측 프록시(server-side proxy)를 통해 라우팅해야 했습니다. 프론트엔드에서 API를 호출하는 무언가를 구축하고 있다면, 배포한 후가 아니라 지금 바로 확인하세요. 제 에이전트들은 완료되지 않은 작업들을 계속 '완료(done)'로 표시하곤 했습니다. 그래서 에이전트 중 하나에게 명시적인 규칙을 주었습니다: 커밋 해시(commit hash), 통과된 테스트, 또는 증거로서의 스크린샷 없이는 아무것도 '완료(Done)'로 넘어갈 수 없다는 규칙입니다. 이것이 실제 공백들을 잡아냈습니다. 한 번은 제가 누락된 검증을 제공할 때까지 작업을 종료하기를 단호히 거부하기도 했습니다. 전체 구축 과정에서 내린 최고의 결정이었습니다. 6월 업데이트의 새로운 중첩 서브 에이전트(nested sub-agents)는 진정으로 이 구조의 형태를 바꿉니다. 하나의 평면적인 에이전트 목록 대신, 리드가 자체적인 하위 작업(sub-tasks)을 생성하는 전문가들에게 업무를 위임할 수 있습니다. 현재 게시되는 대부분의 내용은 여전히 예전의 평면적인 패턴을 사용하고 있습니다. 구체적인 내용이 필요한 분이 있다면 실제 에이전트 설정(agent configs), 보안 프록시 패턴(security-proxy pattern), 또는 '증거 요구(proof required)' 설정을 기꺼이 공유하겠습니다. 아무도 요청하지 않은 코드 뭉치를 쏟아내고 싶지는 않았습니다. 여러분은 멀티 에이전트(multi-agent) 설정에서 어떤 문제들을 겪고 계신가요?