Claude Code 에이전트 팀

이 과정의 원칙

에이전트 팀은 사람 수를 흉내 내는 프롬프트 모음이 아니다. 저장소의 업무 기준을 읽고, 작은 작업을 검증하며, 권한이 필요한 동작은 사람이 승인하는 운영 방식이다.

먼저 정할 것	이유
프로젝트 지침과 완료 기준	에이전트가 무엇을 바꿔도 되는지 분명해진다.
스킬과 역할	반복되는 절차와 전문 검토 기준을 재사용할 수 있다.
데이터·도구 권한	고객 정보·비밀값·외부 변경을 안전하게 제한한다.
검증과 인계	테스트·빌드·브라우저 확인·되돌리기 근거가 남는다.

추천 학습 순서

1. 1~2장에서 현재 공식 설치·설정 문서와 프로젝트 지침 구조를 확인한다.
2. 3장과 부록 A에서 한 번에 한 업무를 반복 가능한 스킬로 정리한다.
3. 4~7장의 팀 예시는 조직도를 자동화하는 설계도가 아니라, 역할·검토·인계 질문을 익히는 템플릿으로 사용한다.
4. 부록 B에서 읽기 전용 연결부터 검증하고, 부록 C에서 오류와 비밀값 노출을 안전하게 처리한다.

시작 전 체크리스트

• 현재 버전의 공식 문서에서 설치·설정 명령을 확인했는가?
• 저장소에 사람의 책임 범위와 금지 데이터가 적혀 있는가?
• 작은 읽기·초안 작업부터 테스트했는가?
• 코드·설정·외부 동작은 적절한 검토와 승인 뒤에 실행되는가?
• 토큰·비밀번호·고객 데이터가 저장소와 대화 기록에 없는가?

명령, 모델 이름, 패키지, 연결 방식은 변할 수 있다. 각 레슨의 예시를 실행하기 전에는 이 과정의 검토일과 제공사의 최신 공식 문서를 함께 확인한다.