Plugin

relay

Name: relay
Author: yarang

Teammate-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.

Component Overview

/setup, /setup-keys +17

Commands

Agents

Skills

Hooks

MCP Servers

LSP Servers

Output Styles

Install

npx claudepluginhub yarang/relay-plugin

Component Details

Commands (19)

/relay:setup

/setup

팀 운용 환경을 초기화합니다. **프로젝트 시작 시 1회 실행**합니다.

/relay:setup-keys

/setup-keys

외부 LLM API(Gemini, OpenAI, Zhipu AI)의 API 키를 안전하게 설정합니다.

/relay:define-expert

/define-expert

전문가의 **기능 정의**를 작성하고 `.claude/relay/experts/` 에 저장합니다.

/relay:define-executor

/define-executor

실행 환경을 정의하고 `.claude/relay/executors/` 에 저장합니다.

/relay:define-agent

/define-agent

Expert + Executor를 바인딩하여 실행 인스턴스(Agent)를 정의하고 `.claude/relay/agents/` 에 저장합니다.

/relay:build-team

/build-team

정의된 전문가들을 조합해 팀을 구성하고 `.claude/relay/teams/` 에 저장합니다.

/relay:invoke-agent

/invoke-agent

CLI 기반 외부 모델 호출로 전문가를 실행합니다.

/relay:visualize-team

/visualize-team

현재 저장된 팀 구성 파일과 전문가 정의 파일을 읽어 Mermaid 다이어그램으로 시각화합니다.

/relay:write-design-decision

/write-design-decision

설계 결정을 DDL(Design Decision Log) 파일로 문서화합니다. **상위팀 전용** 스킬입니다.

/relay:escalate

/escalate

팀 내에서 해결할 수 없는 이슈를 상위팀에 전달합니다.

/relay:read-context

/read-context

공유 컨텍스트를 조회합니다. 모든 역할이 사용할 수 있습니다.

/relay:progress-sync

/progress-sync

역할에 따라 맞춤화된 진행 현황을 조회·보고합니다.

회의록을 제어합니다.

TDD 사이클 단계를 기록하고 PLAN 파일 체크박스를 업데이트합니다. **dev 도메인 전용** 스킬입니다.

/relay:dev:ddd-design

/ddd-design

도메인 모델과 유비쿼터스 언어를 설계합니다. **dev 도메인 전용** 스킬입니다.

/relay:dev:create-implementation-plan

/create-implementation-plan

DDL을 체크리스트 기반 구현 계획(PLAN)으로 변환합니다. **dev 도메인 전용**, **팀 리더 전용** 스킬입니다.

/relay:export-templates

/export-templates

프로젝트 scope 템플릿(`.claude/relay/templates/`)을 다른 프로젝트에서 재사용할 수 있도록 내보냅니다.

/relay:import-templates

/import-templates

다른 프로젝트에서 내보낸 템플릿을 현재 프로젝트의 project scope로 가져옵니다.

/relay:message

/message

에이전트 간 실시간 메시지를 전송합니다.

README

relay

프롬프트 기반 계층형 에이전트 팀 프레임워크

사용자 정의 전문가와 계층형 팀 구조를 프롬프트만으로 유연하게 설계·운용하는 Claude Code 확장.

특징: 코드 없이, 지침과 명령어만으로 작동합니다.

지원 LLM: Claude (기본), Google Gemini, OpenAI GPT, Zhipu AI GLM

설치 — 플러그인 설치 · 초기화 · 외부 LLM 설정
빠른 시작
핵심 개념
전문가 백엔드 — backed_by
MCP 기반 외부 LLM 전문가
실행 모드 — in-process / teammate / subagent
context-compressor — 컨텍스트 압축 시스템
사용 방법
팀 구조 시각화
스킬 레퍼런스
회의록
데이터 저장 구조
플러그인 구조
제한사항

설치

# 마켓플레이스 등록 (최초 1회)
claude plugin marketplace add yarang/relay-plugin

# 플러그인 설치
claude plugin install relay@relay-plugin

설치 후 /relay:setup 으로 시작합니다. 저장소 구조와 수동 설치는 저장소 루트 README 를 참조하세요.

빠른 시작

일반팀 (general)

1. /relay:setup              → 도메인 선택: general
2. /relay:setup-keys         → Gemini / OpenAI / Zhipu AI 키 설정 (외부 LLM 사용 시)
3. /relay:define-expert      → 전문가 정의 (여러 명 반복)
4. /relay:build-team         → 팀 구성
5. steering-orchestrator 호출 → 업무 시작

개발팀 (development)

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

Steering Team (상위팀): 아키텍처 결정, 도메인 모델 설계, 팀 간 조율
team-leader (하위팀 리더): 상위팀 결정을 팀원에게 전달, 작업 배분, 진행 관리, 에스컬레이션
developer / 전문가: 실제 구현 또는 작업 수행

조합형 에이전트 정의

relay는 전문가 정의와 별도로, 재사용 가능한 에이전트 조합을 파일로 관리합니다. backend developer 같이 공통 능력은 같고 플랫폼만 다른 역할에 적합합니다.

조합 단위는 5개입니다.

레이어	예시
`base`	`backend-core`
`spec`	`crud`, `rest-api`, `list-filter-sort`, `auth-jwt`
`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

전문가 정의 시 backed_by 를 지정하면, /relay:invoke-agent 호출 시 해당 백엔드로 작업을 위임합니다.

backed_by 우선순위 규칙

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:* — 내부 에이전트

계층 구조 에이전트

값	도메인	설명
`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	조사·분석 담당 — 시장 조사·요구사항 수집

품질·검증 에이전트

View full README on GitHub

Similar Plugins

nanobanana

Standalone image generation plugin using Nano Banana MCP server. Generates and edits images, icons, diagrams, patterns, and visual assets via Gemini image models. No Gemini CLI dependency required.

Stats

Version0.5.0

Stars0

MaintenanceExcellent

AddedApr 6, 2026

Actions

View on GitHub View README Plugin Marketplace JSON

relay

프롬프트 기반 계층형 에이전트 팀 프레임워크

사용자 정의 전문가와 계층형 팀 구조를 프롬프트만으로 유연하게 설계·운용하는 Claude Code 확장.

특징: 코드 없이, 지침과 명령어만으로 작동합니다.

지원 LLM: Claude (기본), Google Gemini, OpenAI GPT, Zhipu AI GLM

설치 — 플러그인 설치 · 초기화 · 외부 LLM 설정
빠른 시작
핵심 개념
전문가 백엔드 — backed_by
MCP 기반 외부 LLM 전문가
실행 모드 — in-process / teammate / subagent
context-compressor — 컨텍스트 압축 시스템
사용 방법
팀 구조 시각화
스킬 레퍼런스
회의록
데이터 저장 구조
플러그인 구조
제한사항

설치

# 마켓플레이스 등록 (최초 1회)
claude plugin marketplace add yarang/relay-plugin

# 플러그인 설치
claude plugin install relay@relay-plugin

설치 후 /relay:setup 으로 시작합니다. 저장소 구조와 수동 설치는 저장소 루트 README 를 참조하세요.

빠른 시작

일반팀 (general)

1. /relay:setup              → 도메인 선택: general
2. /relay:setup-keys         → Gemini / OpenAI / Zhipu AI 키 설정 (외부 LLM 사용 시)
3. /relay:define-expert      → 전문가 정의 (여러 명 반복)
4. /relay:build-team         → 팀 구성
5. steering-orchestrator 호출 → 업무 시작

개발팀 (development)

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

Steering Team (상위팀): 아키텍처 결정, 도메인 모델 설계, 팀 간 조율
team-leader (하위팀 리더): 상위팀 결정을 팀원에게 전달, 작업 배분, 진행 관리, 에스컬레이션
developer / 전문가: 실제 구현 또는 작업 수행

조합형 에이전트 정의

조합 단위는 5개입니다.

레이어	예시
`base`	`backend-core`
`spec`	`crud`, `rest-api`, `list-filter-sort`, `auth-jwt`
`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

전문가 정의 시 backed_by 를 지정하면, /relay:invoke-agent 호출 시 해당 백엔드로 작업을 위임합니다.

backed_by 우선순위 규칙

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:* — 내부 에이전트

계층 구조 에이전트

값	도메인	설명
`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	조사·분석 담당 — 시장 조사·요구사항 수집

품질·검증 에이전트

relay

Component Overview

Install

Component Details

Commands (19)

README

relay

목차

설치

빠른 시작

일반팀 (general)

개발팀 (development)

핵심 개념

도메인 팩

팀 계층 구조

조합형 에이전트 정의

공유 컨텍스트 권한

전문가 백엔드 — backed_by

backed_by 우선순위 규칙

네임스페이스 전체 목록

relay:* — 내부 에이전트

Similar Plugins

nanobanana

relay

Component Overview

Install

Component Details

Commands (19)

README

relay

목차

설치

빠른 시작

일반팀 (general)

개발팀 (development)

핵심 개념

도메인 팩

팀 계층 구조

조합형 에이전트 정의

공유 컨텍스트 권한

전문가 백엔드 — backed_by

backed_by 우선순위 규칙

네임스페이스 전체 목록

relay:* — 내부 에이전트

Similar Plugins

nanobanana

ui-design

superpowers

team-skills-platform

claude-hud