AI 요약
Claude Code에 '에이전트 팀(Agent Teams)' 기능이 실장되면서, 단순 코딩 보조를 넘어 복잡한 요구사항을 스스로 분해하고 팀 단위로 수행하는 단계에 진입했습니다. 사용자는 ./claude-docs/ 디렉토리에 세션 기억을 저장하고, git worktree를 활용해 독립적인 작업 환경을 구축하며 AI와 협업합니다. 특히 docs-searcher, db-structure-analyzer 등 특정 역할이 부여된 서브 에이전트들을 리더 에이전트가 지휘하는 구조를 통해 문서화부터 실제 구현까지의 성능 저하 없는 작업이 가능해졌습니다. 또한 /save, /simplify 같은 명령어를 통해 코드 변경 사항을 즉시 문서화에 반영하며 최신 상태를 유지하는 것이 핵심입니다.
핵심 인사이트
- 에이전트 팀 구성:
docs-searcher,flow-diagram-generator,db-structure-analyzer등 전문화된 서브 에이전트를 생성하여 복합적인 과제를 수행합니다. - 문서 관리 자동화:
./claude-docs/폴더에 세션 로그와 이슈를 관리하며, AI가 이전 정보를 발견하면/save명령어로 문서를 자동 갱신합니다. - 워크플로우 체계화:
git worktree를 사용하여 소스 코드 리포지토리와 별도의 문서 리포지토리를 병행 운영하며 작업의 병렬성을 확보합니다. - 커스텀 명령어 활용:
/team-issue명령어를 정의해Phase 0부터Phase 3까지 단계별로 팀 구성 및 조사, 구현 계획 수립을 자동화합니다.
주요 디테일
- Hooks 기능 활용:
PostToolUse를 통해 코드 작성 후 공백 제거 스크립트를 실행하며,PreToolUse로claude-coding-rules.md준수 여부를 매번 확인합니다. - 단계별 실행(Phase 0~3): 플랜 모드 확인(0단계) → 에이전트 팀 준비(1단계) → 조사 실행(2단계) → 불명확한 점 확인(3단계)의 체계적 공정을 거칩니다.
- 특정 언어 최적화: PHP, JavaScript, HTML, CSS 조사를 전담하는
Explore 서브 에이전트를 별도로 운영하여 정밀도를 높였습니다. - 제외된 기능들: 읽기/쓰기 미스매치 문제로
.claude/rules/는 사용하지 않으며,MEMORY.md대신 이슈별 개별 마크다운 파일을 선호합니다. - 도구 지정의 중요성:
TeamCreate,AskUserQuestion등 구체적인 툴 이름을 지정해야 에이전트의 실행 누락 확률이 줄어듭니다.
향후 전망
- 에이전트 오케스트레이션 가속화: 개별 AI의 성능 개선보다 여러 전문 에이전트를 관리하는 '리더 AI'의 역할과 오케스트레이션 기술이 개발 자동화의 핵심이 될 것입니다.
- AI 네이티브 개발 환경: Git 조작과 문서화를 AI가 전담하고 인간은 검토(
git diff)만 수행하는 형태의 개발 문화가 확산될 것으로 보입니다.
출처:hatena