Skip to content

fix(agents): replace dangling team-lead protocol with single-return reporting#730

Merged
kcenon merged 1 commit into
developfrom
fix/issue-727-strip-team-protocol
Jun 13, 2026
Merged

fix(agents): replace dangling team-lead protocol with single-return reporting#730
kcenon merged 1 commit into
developfrom
fix/issue-727-strip-team-protocol

Conversation

@kcenon

@kcenon kcenon commented Jun 13, 2026

Copy link
Copy Markdown
Owner

변경 내용

8개 서브 에이전트 정의(plugin/agents/ + project/.claude/agents/, 총 16개 파일)에서 ## Team Communication Protocol 섹션을 제거하고 ## Reporting 섹션으로 대체했다.

배경

이 섹션은 정의되지 않은 team-lead 오케스트레이터로의 핸드오프와, 모든 에이전트의 tools 화이트리스트에 존재하지 않는 SendMessage / TaskCreate / TaskUpdate 도구를 전제로 작성되어 있었다. 그 결과 팀 모드에서 "심각도 높은 발견 시 team-lead에 즉시 통지", "발견마다 TaskCreate 항목 생성", "자기 작업 완료 표시" 같은 지시는 런타임에서 실행할 수 없는 죽은 지시(dead instruction)였다. team-lead는 저장소 어디에도 name: team-lead로 정의되어 있지 않다.

구현

  • 16개 파일에서 ## Team Communication Protocol 섹션(하위 ### Receives From / ### Sends To / ### Handoff Triggers / ### Task Management 포함)을 제거했다.
  • 그 자리에 모든 파일에 동일한 ## Reporting 섹션을 삽입하여 실제 단일 반환(single-return) 실행 모델을 명문화했다. 즉 각 에이전트는 결과를 호출 세션에 반환하고, 후속 위임 여부는 호출 세션이 결정한다.
  • codebase-analyzer.md는 해당 섹션 뒤에 이어지는 ## Process 섹션을 그대로 보존했다.
  • pluginproject 두 레이어의 본문 정합성을 유지했다.

검증

  • scripts/check_agents.shcheck_agents: OK (8 agent pairs in sync)
  • grep "Team Communication Protocol" → 16개 파일 모두 0건
  • grep "## Reporting" → 16개 파일 모두 1건

비고

이번 변경은 옵션 (B) 단일 반환 설계를 택했다. 향후 실제 멀티에이전트 팀 운용을 도입할 경우 team-lead 정의와 협업 도구 부여(옵션 A)로 재작성할 수 있다.

Closes #727
Part of #726

…eporting

The Team Communication Protocol section referenced an undefined team-lead orchestrator and SendMessage/TaskCreate/TaskUpdate tools absent from every agent's tools whitelist, so its handoff and TaskCreate directives were dead instructions in team mode. Replace it with a Reporting section documenting the actual single-return execution model, applied identically across all 8 agents in both the plugin and project layers.
@kcenon kcenon merged commit f77a34e into develop Jun 13, 2026
1 check passed
@kcenon kcenon deleted the fix/issue-727-strip-team-protocol branch June 13, 2026 10:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant