Help us improve
Share bugs, ideas, or general feedback.
Enforces closed-loop communication (send-ack-verify) for agent teams to prevent misunderstandings in handoffs, task instructions, and dependency requests.
npx claudepluginhub tobyilee/team-bigfive --plugin team-bigfiveHow this skill is triggered — by the user, by Claude, or both
Slash command
/team-bigfive:closed-loop-commsThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Team Big Five의 두 번째 조율 메커니즘. 정보가 **전달되고, 이해되고, 검증되었음**을 닫힌 루프로 확인한다. 단방향 발신(fire-and-forget)은 에이전트 팀에서 조용한 실패의 가장 흔한 원인이다.
Structured messaging protocols for agent team communication: message type selection, plan approval, shutdown procedures, and anti-patterns to avoid.
Use when dispatching subagents, composing prompts for teammates, structuring handoff reports, or managing context boundaries between agents. Covers both subagent prompts and team-level messaging.
Implements PACT agent teams protocol for task claiming, teachback verification, inter-agent messaging with SendMessage, blocker reporting, and work handoffs.
Share bugs, ideas, or general feedback.
Team Big Five의 두 번째 조율 메커니즘. 정보가 전달되고, 이해되고, 검증되었음을 닫힌 루프로 확인한다. 단방향 발신(fire-and-forget)은 에이전트 팀에서 조용한 실패의 가장 흔한 원인이다.
A가 B에게 "이 스키마 써"라고 보내고 다음 작업으로 넘어간다. B는 메시지를 놓쳤거나, 받았지만 다르게 이해했다. 둘 다 자기 일을 "성공적으로" 끝냈는데 합쳐보면 어긋난다 — 그리고 아무도 그 사실을 모른다. 폐쇄 루프는 이 침묵을 깨뜨린다.
1. 발신 (Send) : 발신자가 명확한 요청 + 기대 응답을 보낸다
2. 수신 확인 (ACK) : 수신자가 받았음을 알리고 + 이해를 자기 말로 재진술한다
3. 발신 검증 (Verify): 발신자가 재진술을 확인하거나 정정한다
재진술(read-back)이 핵심이다. "알겠음"은 ACK가 아니다 — 무엇을 알겠다는 건지 재진술해야 오해가 드러난다.
발신(team-lead → contributor-api):
"사용자 목록 엔드포인트를 만들어라. 출력은 contributor-ui가 소비한다.
완료 기준: SMM의 인터페이스 섹션 스키마 준수. ACK 요청."
ACK(contributor-api → team-lead):
"확인. GET /users 구현, 응답은 SMM 인터페이스의 User[] 스키마
({id, name, email}) 준수, 완료 시 contributor-ui에 통보. 맞나?"
검증(team-lead → contributor-api):
"맞다. 단 email은 optional. 진행."
| 상황 | 폐쇄 루프 필요? |
|---|---|
| 작업 지시 / 완료 기준 전달 | 필수 — 오해 시 전체 작업 낭비 |
| 인터페이스/계약 핸드오프 | 필수 — 경계면 버그의 근원 |
| 의존 결과 요청 | 필수 — 받았는지 확인해야 다음 진행 |
| 적응(계획 변경) 브로드캐스트 | 필수 — 영향받는 팀원의 ACK 확인 |
| 단순 진행률 공유, FYI | 불필요 — TaskUpdate로 충분, 오버헤드 회피 |
모든 메시지에 ACK를 요구하면 오버헤드로 팀이 마비된다. 작업 결과를 좌우하는 메시지에만 폐쇄 루프를 적용한다.
폐쇄 루프가 확신 있는 전달을 보장한다면, 이 채널은 확신 없음을 가시화한다. 에이전트의 흔한 실패는 모르면서 그럴듯하게 지어내는 것(confabulation)이다. 이를 막는 1차 장치:
폐쇄 루프의 함정: A가 B의 ACK를 기다리고 B는 A의 메시지를 기다리며 둘 다 무한 idle. 규칙: