팀 빌더

팀 빌더은(는) 무엇을 하나요?

요청 시 에이전트 팀을 탐색하고 구성하기 위한 대화형 메뉴입니다. flat 또는 도메인 서브디렉토리 에이전트 컬렉션과 함께 작동합니다.

사용 시기

• 여러 에이전트 persona(마크다운 파일)가 있고 작업에 사용할 에이전트를 선택하고 싶을 때
• 서로 다른 도메인(예: 보안 + SEO + 아키텍처)에서 임시 팀을 구성하고 싶을 때
• 결정하기 전에 어떤 에이전트가 사용 가능한지 탐색하고 싶을 때

전제 조건

에이전트 파일은 persona 프롬프트(정체성, 규칙, 워크플로우, 결과물)를 포함하는 마크다운 파일이어야 합니다. 첫 번째 # 제목이 에이전트 이름으로 사용되고 첫 번째 문단이 설명으로 사용됩니다.

flat 및 서브디렉토리 레이아웃 모두 지원됩니다.

서브디렉토리 레이아웃 — 도메인은 폴더 이름에서 추론됩니다.

agents/
├── engineering/
│   ├── security-engineer.md
│   └── software-architect.md
├── marketing/
│   └── seo-specialist.md
└── sales/
    └── discovery-coach.md

Flat 레이아웃 — 도메인은 공유된 파일 이름 접두사에서 추론됩니다. 접두사는 2개 이상의 파일이 공유할 때 도메인으로 간주됩니다. 고유한 접두사를 가진 파일은 "일반"으로 그룹화됩니다. 참고: 알고리즘은 첫 번째 -에서 분할하므로, 여러 단어로 된 도메인(예: product-management)은 대신 서브디렉토리 레이아웃을 사용해야 합니다.

agents/
├── engineering-security-engineer.md
├── engineering-software-architect.md
├── marketing-seo-specialist.md
├── marketing-content-strategist.md
├── sales-discovery-coach.md
└── sales-outbound-strategist.md

구성

에이전트는 두 가지 방법을 통해 발견되며, 에이전트 이름으로 중복 제거 및 병합됩니다.

1. claude agents 명령어 (기본) — CLI에 알려진 모든 에이전트(사용자 에이전트, 플러그인 에이전트(예: ecc:architect), 내장 에이전트 포함)를 가져오기 위해 claude agents를 실행합니다. 이는 경로 구성 없이 ECC 마켓플레이스 설치를 자동으로 처리합니다.
2. 파일 glob (폴백, 에이전트 콘텐츠 읽기용) — 에이전트 마크다운 파일은 다음 위치에서 읽습니다.
   • ./agents/**/*.md + ./agents/*.md — 프로젝트 로컬 에이전트
   • ~/.claude/agents/**/*.md + ~/.claude/agents/*.md — 전역 사용자 에이전트

이전 소스가 이름 충돌 시 우선합니다: 사용자 에이전트 > 플러그인 에이전트 > 내장 에이전트. 사용자가 지정하는 경우 사용자 정의 경로를 대신 사용할 수 있습니다.

작동 방식

1단계: 사용 가능한 에이전트 탐색

claude agents를 실행하여 전체 에이전트 목록을 가져옵니다. 각 줄을 파싱합니다.

• 플러그인 에이전트는 plugin-name: 접두사가 붙습니다(예: ecc:security-reviewer). : 뒤의 부분을 에이전트 이름으로, 플러그인 이름을 도메인으로 사용합니다.
• 사용자 에이전트에는 접두사가 없습니다. ~/.claude/agents/ 또는 ./agents/에서 해당 마크다운 파일을 읽어 이름과 설명을 추출합니다.
• 내장 에이전트(예: Explore, Plan)는 사용자가 명시적으로 포함을 요청하지 않는 한 건너뜁니다.

마크다운 파일에서 로드된 사용자 에이전트의 경우:

• 서브디렉토리 레이아웃: 상위 폴더 이름에서 도메인을 추출합니다.
• Flat 레이아웃: 모든 파일 이름 접두사(첫 번째 - 앞의 텍스트)를 수집합니다. 접두사는 2개 이상의 파일 이름에 나타나는 경우에만 도메인으로 인정됩니다(예: engineering-security-engineer.md 및 engineering-software-architect.md는 모두 engineering으로 시작 → Engineering 도메인). 고유한 접두사를 가진 파일(예: code-reviewer.md, tdd-guide.md)은 "일반" 아래에 그룹화됩니다.
• 첫 번째 # 제목에서 에이전트 이름을 추출합니다. 제목이 없으면 파일 이름에서 이름을 파생합니다(.md 제거, 하이픈을 공백으로 바꾸고, 제목 대문자로 표시).
• 제목 뒤 첫 번째 문단에서 한 줄 요약을 추출합니다.

claude agents 실행 및 파일 위치 탐색 후 에이전트가 발견되지 않으면 사용자에게 "에이전트를 찾을 수 없습니다. claude agents를 실행하여 설정을 확인하세요."라고 알린 후 중지합니다.

2단계: 도메인 메뉴 표시

사용 가능한 에이전트 도메인:
1. Engineering — Software Architect, Security Engineer
2. Marketing — SEO Specialist
3. Sales — Discovery Coach, Outbound Strategist

도메인을 선택하거나 특정 에이전트 이름을 입력하세요(예: "1,3" 또는 "security + seo"):

• 에이전트가 0개인 도메인(빈 디렉토리)은 건너뜁니다.
• 도메인별 에이전트 수를 표시합니다.

3단계: 선택 처리

유연한 입력을 허용합니다.

• 숫자: "1,3"은 Engineering과 Sales의 모든 에이전트를 선택합니다.
• 이름: "security + seo"는 발견된 에이전트와 퍼지 매칭됩니다.
• "engineering에서 전부"는 해당 도메인의 모든 에이전트를 선택합니다.

5명 이상의 에이전트가 선택된 경우, 알파벳 순으로 나열하고 사용자에게 범위를 좁히도록 요청합니다: "N개의 에이전트를 선택했습니다(최대 5개). 유지할 에이전트를 선택하거나 '첫 5개'라고 말하면 알파벳 순으로 처음 5개를 사용합니다."

선택 확인:

선택됨: Security Engineer + SEO Specialist
어떤 작업을 수행할까요? (작업 설명):

4단계: 에이전트 병렬 실행

1. 각 선택된 에이전트의 마크다운 파일을 읽습니다.
2. 아직 제공되지 않은 경우 작업 설명을 요청합니다.
3. Agent 도구를 사용하여 모든 에이전트를 병렬로 실행합니다.
   • subagent_type: "general-purpose"
   • prompt: "{에이전트 파일 내용}\n\n작업: {작업 설명}"
   • 각 에이전트는 독립적으로 실행됩니다. 에이전트 간 통신은 필요하지 않습니다.
4. 에이전트가 실패하면(오류, 시간 초과 또는 빈 출력) 실패 내용을 인라인으로 기록(예: "Security Engineer: 실패 — [사유]")하고 성공한 에이전트의 결과로 계속 진행합니다.

5단계: 결과 종합

모든 출력을 수집하고 통합 보고서를 제공합니다.

• 에이전트별로 그룹화된 결과
• 종합 섹션에서 강조:
  • 에이전트 간 일치점
  • 권장 사항 간의 충돌 또는 긴장 관계
  • 권장되는 다음 단계

에이전트가 1명만 선택된 경우 종합을 건너뛰고 출력을 직접 제공합니다.

규칙

• 동적 탐색만 가능. 에이전트 목록을 하드코딩하지 마십시오. 디렉토리의 새 파일이 메뉴에 자동으로 나타납니다.
• 팀당 최대 5명의 에이전트. 5명을 초과하면 수확 체감이 나타나고 토큰 사용량이 과도해집니다. 선택 시점에 적용합니다.
• 병렬 파견. 모든 에이전트가 동시에 실행됩니다. Agent 도구의 병렬 호출 패턴을 사용합니다.
• 병렬 Agent 호출, TeamCreate 아님. 이 스킬은 독립적인 작업을 위해 병렬 Agent 도구 호출을 사용합니다. TeamCreate(멀티에이전트 대화를 위한 Claude Code 도구)는 에이전트가 서로 토론하거나 응답해야 할 때만 필요합니다.

예시

사용자: 팀 빌더

Claude:
사용 가능한 에이전트 도메인:
1. Engineering (2) — Software Architect, Security Engineer
2. Marketing (1) — SEO Specialist
3. Sales (4) — Discovery Coach, Outbound Strategist, Proposal Strategist, Sales Engineer
4. Support (1) — Executive Summary

도메인을 선택하거나 특정 에이전트 이름을 입력하세요:

사용자: security + seo

Claude:
선택됨: Security Engineer + SEO Specialist
어떤 작업을 수행할까요?

사용자: 내 Next.js 전자상거래 사이트를 출시 전에 검토해 줘

[두 에이전트가 병렬로 실행되며, 각각 코드베이스에 전문성을 적용합니다]

Claude:
## Security Engineer 발견 사항
- [발견 사항...]

## SEO Specialist 발견 사항
- [발견 사항...]

## 종합
두 에이전트 모두 다음에 동의합니다: [...]
긴장 관계: Security는 인라인 스타일을 차단하는 CSP를 권장하지만, SEO는 인라인 스키마 마크업이 필요합니다. 해결 방안: [...]
다음 단계: [...]