AI 도서관 · Claude · 하네스 설정 · 에이전트끼리 소통

여럿 붙였는데 더 느려질 때

사람을 늘리면 조율 비용도 같이 늡니다. 손해인 경우들

내용

📌 여럿이 항상 빠른 게 아닙니다

공식 문서가 꼽는, 오히려 손해인 경우들입니다.

✗ 순서대로 해야 하는 일
   앞이 끝나야 뒤를 할 수 있으면 나눌 것이 없습니다

✗ 같은 파일을 만지는 일
   두 명이 같은 파일을 고치면 덮어씁니다
   파일을 나눠서 맡기세요

✗ 서로 물려 있는 일이 많은 일
   기다리는 시간이 일하는 시간보다 길어집니다

✗ 조각이 너무 작은 일
   나누고 합치는 비용이 이득보다 큽니다

📌 일의 크기 정하기
너무 작으면 — 조율 비용이 이득을 넘습니다
너무 크면 — 오래 확인 없이 달리다 헛일을 합니다
알맞으면 — 결과물 하나가 딱 나오는 크기
            (함수 하나, 테스트 파일 하나, 검토 하나)

한 명당 5~6개 정도가 적당합니다.
막히면 다른 사람에게 넘길 여유가 생깁니다.

📌 흔한 증상과 대처

팀장이 기다리지 않고 직접 하기 시작한다
  → "팀원들 끝날 때까지 기다려" 라고 말해주세요

일이 남았는데 끝났다고 한다
  → 계속하라고 하면 됩니다

팀원이 오류를 만나고 멈춰 있다
  → 그 팀원을 골라 들어가 직접 지시하거나 새로 띄웁니다

완료 표시가 안 돼서 다음 일이 안 풀린다
  → 실제로 끝났는지 보고 상태를 직접 고칩니다

📌 처음이라면 코드를 안 쓰는 일부터
검토·조사·원인 찾기가 좋습니다.
경계가 분명하고 서로 부딪칠 파일이 없습니다.

⚠️ 오래 방치하지 마세요
   가끔 들여다보고 방향을 잡아주는 편이,
   나중에 통째로 다시 하는 것보다 쌉니다.

⚠️ 할 일이 15개라도 3명으로 시작하세요
   공식 권장입니다. 집중한 3명이 흩어진 5명보다 낫습니다.

궁금한 점: {{INPUT}}

{{INPUT}} 자리에 내 내용을 넣어 쓰는 프롬프트입니다. 아래 버튼으로 열면 넣는 칸이 나옵니다.

근거

유형
공식 기능·명령 — 해당 제품에서 실제로 동작합니다
사용 환경
Claude Code 에이전트 팀
주의
팀원 수와 토큰은 비례합니다. 늘린 만큼 빨라지지는 않습니다.
공식 출처
https://code.claude.com/docs/en/agent-teams
확인일
2026-09-09 — 이후 바뀌었을 수 있습니다
도서관에서 열기 — 내 내용 넣고 복사하기