team

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. 리더가 요청을 독립 작업 단위로 분해합니다.
2. 팀을 만들고 모든 작업을 병렬로 위임합니다.
3. 각 팀원은 자기 작업을 독립적으로 수행합니다.
4. 1차 결과가 모이면 서로의 결과를 교차 검증합니다.
5. 리더가 전체 결과와 검증 의견을 합쳐 사용자에게 보고합니다.

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:

1. 2+ independent subtasks that can be parallelized
2. 2+ different files or domains (e.g., frontend + backend, hook + config)
3. 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