npx claudepluginhub yarang/relay-pluginTeammate-mode hierarchical agent team framework for Claude Code. Define expert personas, build layered teams, and delegate across Claude and external LLMs using Claude Code's native Agent Teams. Requires CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1.
프롬프트 기반 계층형 에이전트 팀 프레임워크
사용자 정의 전문가와 계층형 팀 구조를 프롬프트만으로 유연하게 설계·운용하는 Claude Code 확장.
특징: 코드 없이, 지침과 명령어만으로 작동합니다.
지원 LLM: Claude (기본), Google Gemini, OpenAI GPT, Zhipu AI GLM
# 마켓플레이스 등록 (최초 1회)
claude plugin marketplace add yarang/relay-plugin
# 플러그인 설치
claude plugin install relay@relay-plugin
설치 후 /relay:setup 으로 시작합니다. 저장소 구조와 수동 설치는 저장소 루트 README 를 참조하세요.
1. /relay:setup → 도메인 선택: general
2. /relay:setup-keys → Gemini / OpenAI / Zhipu AI 키 설정 (외부 LLM 사용 시)
3. /relay:define-expert → 전문가 정의 (여러 명 반복)
4. /relay:build-team → 팀 구성
5. steering-orchestrator 호출 → 업무 시작
1. /relay:setup → 도메인 선택: development
2. /relay:setup-keys → 외부 LLM 키 설정 (선택)
3. /relay:define-expert → 전문가 정의
4. /relay:build-team → 상위팀 + 하위팀 구성
5. steering-orchestrator 호출
→ /relay:dev:ddd-design 도메인 모델 설계
→ /relay:write-design-decision DDL 문서화
6. team-leader 호출
→ /relay:dev:create-implementation-plan PLAN 생성 ⭐
→ 팀원 작업 배분
7. developer 호출
→ /relay:dev:tdd-cycle RED / GREEN / REFACTOR
→ /relay:progress-sync
8. 조합형 에이전트 호출이 필요하면
→ /relay:invoke-agent
9. 현재 팀 구성을 도식으로 보면
→ /relay:visualize-team
/relay:setup 실행 시 도메인을 선택합니다. 선택한 도메인에 따라 활성화되는 스킬이 달라집니다.
| 팩 | 활성 스킬 | 주요 대상 |
|---|---|---|
general | 코어 스킬 | 마케팅·법무·기획·영업 등 |
development | 코어 + dev 팩 | 소프트웨어 개발팀 |
설정은 .claude/relay/domain-config.json 에 저장되며, 언제든 /relay:setup 으로 변경할 수 있습니다.
graph TD
ST["🏛️ Steering Team<br/>아키텍처 결정 · 팀 간 조율 · DDL 작성"]
L1["👔 team-leader (백엔드팀)"]
L2["👔 team-leader (프론트엔드팀)"]
D1["💻 developer"]
D2["💻 developer"]
D3["💻 developer"]
ST --> L1
ST --> L2
L1 --> D1
L1 --> D2
L2 --> D3
L1 -.->|진행 보고 · 에스컬레이션| ST
L2 -.->|진행 보고 · 에스컬레이션| ST
relay는 전문가 정의와 별도로, 재사용 가능한 에이전트 조합을 파일로 관리합니다.
backend developer 같이 공통 능력은 같고 플랫폼만 다른 역할에 적합합니다.
조합 단위는 5개입니다.
| 레이어 | 예시 |
|---|---|
base | backend-core |
capability | crud, rest-api, list-filter-sort, auth |
platform | fastapi, django |
policy | project-default, repo-api-style |
task overlay | 주문 목록 API 추가 |
실행 시 합성 순서:
base + specs + platform + policy + task → 최종 런타임 인스트럭션
상세 규약은 docs/agent-definition-and-invocation.md 참조.
| 디렉토리 | 상위팀 | 리더 | 개발자/팀원 |
|---|---|---|---|
design-decisions/ | 읽기·쓰기 | 읽기 | 읽기 |
domain-models/ | 읽기·쓰기 | 읽기 | 읽기 |
implementation-plans/ | 읽기 | 읽기·쓰기 | 체크박스만 |
test-reports/ | 읽기 | 읽기·쓰기 | 읽기·쓰기 |
interface-contracts/ | 읽기·쓰기 | 읽기·쓰기 | 읽기 |
escalations/ | 읽기·쓰기 | 읽기·쓰기 | ❌ |
meetings/ | log만 | log만 | log만 |
전문가 정의 시 backed_by 를 지정하면, /relay:invoke-agent 호출 시 해당 백엔드로 작업을 위임합니다.
expert 파일의 backed_by 는 조합형 definition 의 default_agent 보다 항상 우선합니다.
expert.backed_by 있음 → 이 값으로 실행 (definition.default_agent 무시)
expert.backed_by 없음 → definition.default_agent 사용
예시: agent_profile: security-auditor (definition.default_agent = codex:gpt-4o) 인 전문가에게
backed_by: zai:glm-4 를 설정하면 → Zai 로 실행되고 codex 는 무시됩니다.
| 네임스페이스 | 백엔드 | 비고 |
|---|---|---|
relay:* | relay 내부 에이전트 | 별도 설치 불필요 |
gemini:* | Google Gemini (MCP) | API 키 + MCP 서버 필요 |
codex:* | OpenAI GPT / o 시리즈 (MCP) | API 키 또는 OAuth |
zai:* | Zhipu AI GLM 시리즈 (MCP) | API 키, glm-4-flash 무료 |
null | 직접 정의 | 외부 위임 없음 |
계층 구조 에이전트
| 값 | 도메인 | 설명 |
|---|---|---|
relay:steering-orchestrator | 공통 | 상위팀 오케스트레이터 — 아키텍처 결정·팀 간 조율 |
relay:team-leader | 공통 | 팀 리더 — 작업 배분·진행 관리·에스컬레이션 |
relay:team-leader-zai | 공통 | Zai(GLM) 기반 팀 리더 (비용 절감) |
실행 담당 에이전트
| 값 | 도메인 | 설명 |
|---|---|---|
relay:developer | development | 구현 담당 — TDD/DDD 사이클 지원 |
relay:developer-zai | development | Zai(GLM) 기반 개발자 (비용 절감) |
relay:specialist | general | 범용 실행 담당 — 마케팅·법무·기획·영업 등 |
relay:researcher | general | 조사·분석 담당 — 시장 조사·요구사항 수집 |
품질·검증 에이전트