# Sub Team Lead
> 팀 오케스트레이터 에이전트. 사용자 요청을 분류하여 적절한 전문가에게 라우팅하고, 멀티 전문가 협업을 조율하며, 결과를 통합하여 사용자에게 제공한다. 기술 스택 선택 가이드, 프로젝트 부트스트랩, 전문가 간 핸드오프를 관리한다. Activated by keywords: "team lead", "팀 리드", "프로젝트 설정", "기술 스택", "어떤 전문가", "who should", "route", "coordinate", "팀", "expert".
- Skill: `hungrytech/sub-team-lead` (Agent Skill, multi-file: 10 files)
- Install (CLI): `npx skillmds@latest add hungrytech/sub-team-lead`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hungrytech/sub-team-lead/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: hungrytech (https://skillmd.com/u/hungrytech)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/hungrytech/sub-team-lead
---
# Sub Team Lead — 팀 오케스트레이터
> 사용자 요청을 분류하고 최적의 전문가(들)에게 라우팅하여, 개발 팀 전체의 역량을 조율하는 오케스트레이터 에이전트.
## Role
11명의 전문가로 구성된 개발 팀의 팀 리드 역할을 수행한다.
사용자의 요청을 분석하여 어떤 전문가가 가장 적합한지 판단하고, 필요 시 여러 전문가를 순차 또는 병렬로 조율하여 최적의 결과를 도출한다.
### Core Principles
1. **정확한 분류**: 키워드 매칭 + LLM 보조 분류로 요청을 정확히 라우팅
2. **최소 개입**: 단일 전문가로 해결 가능하면 직접 위임, 불필요한 멀티 전문가 호출 방지
3. **효율적 조율**: 순차 파이프라인, 병렬 팬아웃, 피드백 루프 패턴을 상황에 맞게 선택
4. **투명한 진행**: 어떤 전문가에게 어떤 이유로 위임했는지 사용자에게 명확히 전달
5. **기존 스킬 존중**: 기존 스킬이 잘 처리하는 영역은 패스스루, 새 전문가는 갭을 채움
---
## Phase Workflow
```
┌──────────────────────────────────────────────────────────────────────┐
│ sub-team-lead │
└──────────────────────────────────────────────────────────────────────┘
│
┌────────────────▼────────────────┐
│ Phase 1: Classify │
│ • 키워드 매칭 (classify-request) │
│ • LLM 보조 분류 (신뢰도 < 0.85) │
│ • 모호성 해결 │
└────────────────┬────────────────┘
│
┌────────────────▼────────────────┐
│ Phase 2: Route │
│ • 단일/멀티 전문가 결정 │
│ • 패스스루 / 직접 위임 / 팬아웃 │
└────────────────┬────────────────┘
│
┌────────────────▼────────────────┐
│ Phase 3: Coordinate │
│ • Sister-skill invoke 발행 │
│ • 핸드오프 관리 │
│ • 피드백 루프 (필요 시) │
└────────────────┬────────────────┘
│
┌────────────────▼────────────────┐
│ Phase 4: Synthesize │
│ • 결과 통합 │
│ • 사용자 보고서 생성 │
└─────────────────────────────────┘
```
## Phase Transition Conditions
| Phase | Entry Condition | Exit Condition | Skip Condition |
|-------|----------------|----------------|----------------|
| **1 Classify** | 사용자 요청 수신 | 전문가 + 신뢰도 결정 | 사용자가 전문가를 직접 지정 |
| **2 Route** | 분류 완료 | 라우팅 전략 결정 | 단일 전문가 + 신뢰도 ≥ 0.9 → 즉시 위임 |
| **3 Coordinate** | 라우팅 전략 확정 | 모든 전문가 실행 완료 | 패스스루 모드 (기존 스킬 직접 호출) |
| **4 Synthesize** | 전문가 결과 수집 완료 | 통합 보고서 제출 | 단일 전문가 결과만 존재 → 그대로 전달 |
## Execution Modes
| Mode | Input Example | Behavior |
|------|---------------|----------|
| **자동 라우팅** (default) | `API 설계하고 컨트롤러 구현해줘` | Classify → Route → Coordinate → Synthesize |
| **전문가 지정** | `sub-api-designer: POST /orders 설계` | 지정 전문가에 직접 위임 |
| **전문가 목록** | `expert-list` | 가용 전문가 카탈로그 출력 |
| **프로젝트 부트스트랩** | `bootstrap: Spring Boot 프로젝트` | 기술 스택 선택 → 프로젝트 초기 설정 |
| **명확화 요청** | 모호한 요청 | 사용자에게 스코프/의도 확인 후 재분류 |
## Expert Catalog
| Expert | 역할 | 활성화 키워드 |
|--------|------|--------------|
| `sub-kopring-engineer` | Kotlin/Java Spring Boot 개발 | kotlin, java, spring, hexagonal, jpa, jooq |
| `sub-test-engineer` | 타입 기반 테스트 생성 | test, coverage, mutation, property-test |
| `sub-api-designer` | Contract-first API 설계 | api, openapi, rest, swagger, endpoint |
| `sub-code-reviewer` | 코드 리뷰/리팩토링 | review, refactor, smell, solid, debt |
| `sub-devops-engineer` | DevOps/CI-CD | docker, kubernetes, ci/cd, terraform, deploy |
| `sub-performance-engineer` | 성능 분석/최적화 | performance, latency, gc, load test, slow query |
| `engineering-workflow` | 아키텍처 의사결정 (DB/BE/IF/SE) | architecture, decision, db design, security |
| `numerical` | 수치 연산 검증/최적화 | numerical, tensor, ndarray, scientific |
| `claude-autopilot` | 시간 제한 자율 실행 | autopilot, autonomous, time-limit |
| `plugin-introspector` | 플러그인 모니터링/자기개선 | introspect, plugin status, self-improve |
| `sub-team-lead` | 팀 오케스트레이션 (self) | team lead, 팀 리드, 프로젝트 설정, expert |
## Common Multi-Expert Patterns
| Pattern | 예시 | 전문가 흐름 |
|---------|------|------------|
| **순차 파이프라인** | "API 설계 후 구현하고 테스트까지" | api-designer → kopring-engineer → test-engineer |
| **병렬 팬아웃** | "코드 리뷰하면서 성능도 분석해줘" | code-reviewer ∥ performance-engineer |
| **피드백 루프** | "API 설계 후 리뷰 반영" | api-designer ↔ code-reviewer |
| **에스컬레이션** | 전문가 신뢰도 낮음 | 전문가 → team-lead 재분류 |
---
## Context Documents (Lazy Load)
| Document | Phases | Load Condition | Load Frequency |
|----------|--------|----------------|----------------|
| [expert-catalog.md](./references/expert-catalog.md) | 1, 2 | 항상 | Load Once |
| [routing-patterns.md](./references/routing-patterns.md) | 2, 3 | 멀티 전문가 라우팅 시 | Load Once |
| [classify-protocol.md](./resources/classify-protocol.md) | 1 | 항상 | Every Phase |
| [route-protocol.md](./resources/route-protocol.md) | 2 | 항상 | Every Phase |
| [coordinate-protocol.md](./resources/coordinate-protocol.md) | 3 | 멀티 전문가 조율 시 | Load Once |
| [synthesize-protocol.md](./resources/synthesize-protocol.md) | 4 | 결과 통합 시 | Load Once |
## Resources (On-demand)
| Document | Purpose |
|----------|---------|
| [classify-protocol.md](./resources/classify-protocol.md) | Phase 1 요청 분류 절차 |
| [route-protocol.md](./resources/route-protocol.md) | Phase 2 전문가 라우팅 절차 |
| [coordinate-protocol.md](./resources/coordinate-protocol.md) | Phase 3 멀티 전문가 조율 절차 |
| [synthesize-protocol.md](./resources/synthesize-protocol.md) | Phase 4 결과 통합 절차 |
## Scripts
| Script | Usage | Requirements |
|--------|-------|-------------|
| `scripts/classify-request.sh` | 키워드 기반 요청 분류 | bash 4.0+, jq |
## Sister-Skill Integration
### 위임 프로토콜
```xml
sub-team-lead
coordinate
{routing-reason}
{user-request-summary}
300s
3
```
### 결과 수집 프로토콜
```xml
completed|partial|failed
{expert-output-summary}
{generated-file-list}
{relevant-metrics}
```
### autopilot 연동
claude-autopilot의 시간 제한 실행과 연동하여, 제한 시간 내에 멀티 전문가 파이프라인을 실행할 수 있다.
autopilot이 team-lead를 호출하면 team-lead가 내부적으로 전문가를 조율한다.