| name | team |
| context | fork |
| description | Parallel team execution with cross-check — the leader delegates, teammates work independently, then verify each other. Use when the user asks for parallel independent work with cross-verification. Triggers: team, parallel team, cross-check, verification, 팀, 병렬 팀, 팀원들, 병렬로. |
| lang | ["en"] |
| triggers | ["team","팀","parallel team","병렬 팀","cross-check","verification","팀원들","병렬로"] |
| platforms | ["claude-code","gemini-cli","codex-cli","cursor"] |
| level | 2 |
| category | orchestration |
| tokens | 2500 |
| agents | ["orchestrator","planner"] |
| source_hash | cd022fd3 |
| whenNotToUse | Single-file edits under 30 lines, simple single-domain tasks, or requests explicitly flagged with --no-team where inline execution is more efficient than parallel team overhead. Deterministic homogeneous fan-out (the same command repeated across many inputs) should prefer the harness Workflow tool over /team, since /team is adaptive model-driven orchestration while a repeated-command batch fits a deterministic pipeline. |
/team
리더가 직접 구현하지 않고 작업을 분해해 병렬 팀으로 위임한 뒤, 마지막에 교차 검증까지 수행하는 스킬입니다.
Activation
다음과 같은 요청에서 사용합니다.
- 병렬로 나눠서 진행해줘
- 팀으로 처리해줘
- 서로 검증하면서 병렬 작업해줘
- cross-check가 필요한 독립 작업
Workflow
- 리더가 요청을 독립 작업 단위로 분해합니다.
- 팀을 만들고 모든 작업을 병렬로 위임합니다.
- 각 팀원은 자기 작업을 독립적으로 수행합니다.
- 1차 결과가 모이면 서로의 결과를 교차 검증합니다.
- 리더가 전체 결과와 검증 의견을 합쳐 사용자에게 보고합니다.
Checklist
Progress:
- [ ] 요청을 작업 단위로 분해
- [ ] 팀 생성 및 역할 할당
- [ ] 병렬 실행 시작
- [ ] 각 결과 수집
- [ ] 교차 검증 수행
- [ ] 최종 통합 보고
Worktree 격리 모드 (선택)
병렬 작업 시 파일 충돌을 원천 방지하려면 --worktree 플래그를 사용합니다.
각 팀원이 독립된 Git worktree에서 작업하므로 동일 파일 동시 수정이 안전합니다.
사용법:
/team --worktree "이 기능 구현해줘"
TEAM SETUP 시 적용:
팀 생성 단계에서 isolation: "worktree" 옵션을 지정하면 모든 팀원이 격리된 worktree에서 생성됩니다.
Task(subagent_type, team_name, name, { isolation: "worktree" })
설정: artibot.config.json의 team.worktreeIsolation.enabled를 true로 설정하면 기본 동작이 됩니다.
주의사항:
- 기본값은
enabled: false (opt-in)
- worktree 작업 완료 후 자동으로 결과가 메인 worktree에 병합됩니다
mergeStrategy: "auto" — 충돌 시 git-autopilot-merge 전략 적용
Auto-Apply Mode
team.autoApply: true (default) in artibot.config.json enables automatic team mode.
When enabled, Claude automatically uses /team workflow for requests that meet ALL criteria:
- 2+ independent subtasks that can be parallelized
- 2+ different files or domains (e.g., frontend + backend, hook + config)
- Medium or higher complexity (not a simple single-file edit or question)
Opt-out
| Method | Scope | How |
|---|
| Config | Permanent | team.autoApply: false in artibot.config.json |
| Local | Per-user | Add team.autoApply: false in CLAUDE.local.md |
| Prompt | Per-request | Include --no-team in the prompt |
Guardrails
See: docs/ORCHESTRATION-ROUTING.md — canonical routing reference; explains when team auto-fires vs. when workflow/autopilot require explicit opt-in.
- 리더는 직접 구현보다 분해와 조정에 집중합니다.
- 실제 의존성이 없는 작업만 병렬화합니다.
- 교차 검증 없이 결과를 바로 합치지 않습니다.
- 같은 사람이 자기 결과를 검증하지 않습니다.
- 최종 보고에는 “무엇을 했는지”뿐 아니라 “무엇을 검증했는지”를 함께 적습니다.
Rationalizations
The following table captures common excuses agents make to skip the rigor of this skill, paired with factual rebuttals.
| Excuse | Rebuttal |
|---|
| "solo is faster than coordinating" | solo hits sequential limits; parallel teams finish in wall-clock time, not agent-time |
| "agents will duplicate work" | that is what cross-check is for — duplication is caught and reconciled |
| "the orchestrator is overhead" | orchestrator enforces decomposition and verification — without it you get drift |
| "I will just do it myself" | that scales to one task; teams scale to domains |
| "cross-check is redundant review" | cross-check is independent verification from a different lens — that is how bugs get caught |
