Claude Agent Teams를 쓸모없게 느끼게 만드는 지름길은 메시지를 계속 엉뚱한 대상에게 보내는 것입니다.

티가 잘 나지 않습니다.

팀원에게 테스트를 돌리라고 했다고 생각했는데, 리드에게 말했습니다.

전체 제약을 브로드캐스트했다고 생각했는데, 팀원 한 명에게만 보냈습니다.

결국 팀이 막아 주기로 했던 일을 하게 됩니다.

• 맥락을 다시 설명
• 같은 말 반복
• 누가 듣긴 했는지 의심

이 가이드는 라우팅 플레이북입니다. 리드 vs 팀원 vs 브로드캐스트, 그리고 메시지가 의도한 곳에 도착하게 하는 작은 습관을 다룹니다.

요약

1. Claude Agent Teams에서는 무엇을 말할지 정하기 전에 항상 누구에게 말할지 정합니다.
2. 사용법:
   • 조율과 최종 결정에는 Lead
   • 구체적인 작업에는 팀원
   • 전체 제약에는 브로드캐스트
3. 검증할 수 있는 메시지를 선호합니다:
   • 한 줄 확인 요청("확인 + 현재 단계")
   • 위험한 작업 전에 체크포인트 요약 요청
4. 라우팅을 명시적으로 보여 주는 인터페이스를 원한다면 Happier가 도움이 되는 한 가지 방법입니다. Send to 칩이 있고, 라우팅된 메시지를 "To: …" 카드로 보여 줍니다.

문제

라우팅은 팀의 숨은 비용입니다.

단일 스레드 세션에서는 모든 메시지가 한 곳으로 갑니다.

팀에서는 메시지가 방향이 있는 동작입니다.

그 방향을 명시하지 않으면:

• 작업 중복
• 제약 누락
• "이 팀원은 왜 엉뚱한 걸 하고 있지?"라는 혼란

일반적인 방법과 트레이드오프

• 항상 리드에게 말하기: 안전하지만 팀이 에이전트 하나로 쪼그라듭니다.
• 팀원에게만 말하기: 빠르게 느껴지지만 조율 계층을 잃습니다.
• 모든 걸 브로드캐스트: 잡음이 생기고 책임이 뒤섞입니다.

잘 통하는 라우팅 지도

Lead (조율)

다음이 필요할 때 리드를 씁니다:

• 계획
• 요약
• 팀원 결과물 사이의 충돌 해결
• 최종 결정

좋은 리드 메시지 패턴:

각 팀원이 찾은 것을 요약하고, 의견이 갈리는 부분을 나열한 뒤, 결정 하나를 제안해 줘.

팀원 (실행)

다음일 때 팀원을 씁니다:

• 작업이 명확하고 범위가 정해져 있다
• 입력과 출력을 깔끔하게 설명할 수 있다

좋은 팀원 메시지 패턴:

X를 해 줘. 끝나면 멈춰. 답장에는 (1) 변경한 것, (2) 변경하지 않은 것, (3) 나에게 필요한 것을 포함해 줘.

브로드캐스트 (전체 제약)

다음일 때 브로드캐스트를 씁니다:

• 모두에게 적용되는 제약 메시지
• 조율 메시지("일시 정지", "체크포인트", "다음 단계 후에 멈춰")

좋은 브로드캐스트 메시지:

• "마이그레이션은 건드리지 마."
• "다음 단계가 끝나면 멈추고 요약해."
• "의존성을 설치하려고 하면 먼저 물어봐."

나쁜 브로드캐스트 메시지:

• "이 파일 리팩터링해"(담당자 불명확)
• "이 테스트 고쳐"(누구 책임?)

실전 예시 (복사용)

예시 1: 안전 제약 브로드캐스트

마이그레이션/인증은 건드리지 마. 필요하다고 생각되면 멈추고 물어봐.

예시 2: 테스트 작업을 팀원 한 명에게 라우팅

이 변경에 대한 최소 테스트 계획을 실행해 줘.

답장에 포함할 것:

• 실행한 명령 그대로
• 실패(오류 전문)
• 수정 제안 하나(있다면)

예시 3: 중재를 리드에게 라우팅

두 팀원의 의견이 갈렸어. 양쪽 입장을 5개 글머리로 요약한 다음 하나를 추천해 줘.

메시지가 어디로 갔는지 증명하는 법

핵심은 나중에 라우팅을 검증할 수 있는 것입니다.

인터페이스가 라우팅을 보여 주지 않으면 추측하게 됩니다.

Happier에서는 라우팅된 전송이 구조화된 참여자 메시지로 저장되고, 수신자 라벨("To: …")이 분명한 메시지 카드로 표시됩니다.

팀이 2명보다 커지면 이 정도의 명시성이 필요합니다.

문제 해결

메시지를 보냈는데 엉뚱한 에이전트가 움직임

흔한 원인:

• 명시적으로 라우팅하지 않았다
• 브로드캐스트가 "리드"라고 생각했다

해결:

• 의도한 대상에게 메시지를 다시 보낸다
• 의도하지 않은 대상에게는 멈추고 한 일을 요약하라고 한다

브로드캐스트가 시끄럽게 느껴짐

브로드캐스트는 제약과 조율용이지 작업 할당용이 아닙니다.

브로드캐스트가 작업으로 가득하다면 라우팅이 제 역할을 못 하는 것입니다.

팀원들이 같은 질문을 반복함

체크포인트 규칙을 추가하세요:

확인 질문을 하나 한 다음, 보수적인 해석으로 진행해.

FAQ

모든 메시지를 라우팅해야 하나요?

아니요.

라우팅이 특히 중요한 경우:

• 팀원이 둘 이상이다
• 모두에게 적용되면 안 되는 지시를 내린다

안전한 기본 대상은?

리드입니다.

누가 작업을 맡아야 할지 모르겠다면 리드에게 보내고 위임을 부탁하세요.

흔한 실수

• 세부 작업에 브로드캐스트 사용
• 팀원 한 명에게 갔어야 할 수정을 리드에게 보냄
• 확인/체크포인트 요청을 잊음

관련 가이드

• Claude Agent Teams 관리 방법 (팀원 만들기, 메시지 보내기, 진행 상황 추적)