Claude Code의 서브 에이전트를 3개로 분리하여 개인 개발을 진행하는 설정 방법

요약 (TL;DR)

• 개인 개발 시 Claude Code 1 에이전트 운영은 한계가 있음 → 3개로 분할
• 역할 분담: architect(설계) / implementer(구현・테스트) / reviewer(리뷰어)
• 설정 파일(~/.claude/agents/<name>.md) 샘플 포함 - 주의할 점: 파일을 직접 수정했을 경우 세션 재시작 필수

혼자 모든 것을 처리하게 하면, 특히 리뷰가 부실해지기 쉽습니다.

자신이 작성한 코드를 스스로 검토하는 구조에서는 자신의 편견을 벗어나기가 어렵습니다.

게다가 구현 과정에서 요구사항 변경 사항이 제대로 기록되지 않거나, 프로젝트가 어디까지 진행되었는지 다른 세션에서는 알 수 없게 되는 경우도 있습니다...

Best Practice는 테스터, 마케터, UX 등 더 세분화되지만, 개인 개발 환경에서 4개의 제품을 병행(예시)한다는 전제 하에 최소한 3개로 압축했습니다.

자세한 판단 로직은 Zenn 아티클에 작성했습니다.

이 글에서는 설정 방법에만 초점을 맞춥니다.

1. 세 개의 파일을 ~/.claude/agents/ 에 배치합니다.

~/.claude/agents/
├── architect.md
├── implementer.md
...

WSL의 경우 /home/<user>/.claude/agents/ 입니다.
Windows와 WSL은 별도의 ~/.claude/ 를 가지므로, 사용하는 환경에 배치해야 합니다.

---
name: architect
description: 신규 제품의 요구사항 정의를 진행합니다. 시장 조사・기능 도출・수용 시나리오・기술 선정・일정 계획까지 담당합니다.