team-dev

A workflow for splitting a software task into smaller jobs and assigning independent jobs to coding agents working in separate Git worktrees. A worktree is an isolated working folder connected to the same Git repository.

In plain words
What is it for?
Use it to analyze dependencies, group parallel subtasks, dispatch implementation work, run available checks, and integrate the completed changes. It can also support TDD, which means writing a failing test before the code that makes it pass.
Why use it?
It helps coordinate parallel development while reducing conflicts between agents and checking each job before combining the results.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/cubha/claude-workflow-plugins/team-dev
Any agent
npx skills add cubha/claude-workflow-plugins --skill team-dev
Clone the repo
git clone --depth 1 https://github.com/cubha/claude-workflow-plugins

Made for: Claude Code, Codex.

Per session 78 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,069 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00078 $0.02069
Opus 5 $0.00039 $0.01035
Sonnet 5 $0.00016 $0.00414
Haiku 4.5 $0.00008 $0.00207

Measured 2d ago against content hash 01bbcbcde21c, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

team-dev scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/team-dev/skills/team-dev/SKILL.md · 180 lines

How it starts

The opening of the file, as written. The whole thing — 180 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Team Dev — 팀 에이전트 병렬 개발 오케스트레이터

$ARGUMENTS 에 대해 SubTask를 의존성 분석하고, 병렬 가능 그룹으로 분류한 후, 팀원 에이전트가 worktree 격리 환경에서 동시 구현한다.

ANALYZE → [ DISPATCH → BUILD → VERIFY → INTEGRATE ] × 그룹 → COMPLETE

전제 조건

  • Git 저장소 필수 — worktree 격리를 위해 git init이 완료된 상태여야 한다
  • SubTask 목록 필수 — SubTask 목록을 입력으로 받는다 ($ARGUMENTS에 있거나, 자연어 기능 설명에서 분리 가능해야 한다). 없으면 AskUserQuestion으로 요청한다
  • 프로젝트 규칙 문서(선택) — CLAUDE.md 등 프로젝트 규칙 파일이 있으면 팀원 프롬프트의 컨텍스트로 주입한다
  • 검증 스크립트(선택)verify.sh·npm test·npm run build 등 프로젝트 검증 수단이 있으면 각 SubTask 완료 후 및 통합 시 실행한다 (없으면 정적 검증 단계를 생략한다)

Phase 0: PARSE — 인자 파싱

$ARGUMENTS에서 아래를 추출한다:

항목 추출 대상 기본값
SubTask 목록 TaskList 도구의 기존 목록 또는 자연어 기능 설명 (필수 — 없으면 AskUserQuestion)
--auto 그룹 간 자동 진행 여부 OFF (그룹 완료마다 확인)
--dry-run 의존성 분석 + 그룹 분류만 수행 OFF
--tdd TDD RED 게이트 발동 (test-first 구현) OFF
--no-tdd TDD 제안·태그 모두 끔 (escape hatch) OFF

TDD 의미론: 인터랙티브(--auto 없음)에서는 적격 SubTask에 [TDD]를 붙여 Phase 1-6 승인게이트에 제안 노출한다. --auto 단독이면 자동태그 OFF(전부 test-after), --auto --tdd면 적격 SubTask에 자동 부착(제안 생략), --no-tdd면 판단·제안 모두 끈다. 적격 기준과 절대제외는 아래 Phase 1-1-1 참조. team-dev는 git 필수라 RED 게이트의 실패테스트 선커밋 안전망이 항상 가용하다.

실행 모드 분기

모드 플래그 실행 방식
서브에이전트 모드 (기본) 없음 Agent 도구로 worktree 격리 병렬 spawn
에이전트 팀 모드 (experimental) (Agent Teams 활성 시) 팀 리더가 팀원 인스턴스 생성, Task 할당, 코드 리뷰, 통합 검증

에이전트 팀 모드는 Claude Code의 experimental Agent Teams 기능이 활성화된 환경에서만 동작한다. 활성화돼 있지 않으면 기본 서브에이전트 모드로 진행한다. 상세는 phase-dispatch.md [B] 참조.


Phase 1: ANALYZE — 의존성 분석 및 그룹 분류

SubTask 수집 → 컨텍스트 수집 → UI/UX 설계 → 의존성 분석 → 그룹 구성 → 사용자 승인. 상세 절차는 phase-analyze.md 참조.


Phase 2: DISPATCH — 팀원 배포

그룹 내 각 SubTask를 팀원 에이전트에게 배포한다. 서브에이전트 모드(기본)와 에이전트 팀 모드(experimental) 두 가지 분기. 상세 절차 및 프롬프트 템플릿은 phase-dispatch.md 참조.


Phase 3: BUILD — 빌드 대기

run_in_background: true로 실행했으므로, 각 에이전트 완료 시 자동 알림을 받는다.

Read the full file on GitHub · 180 lines

Files

What ships with it

3 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 180 lines · 78 tokens per session scan A 01bbcbcde21c

Subscribe to this mod's changes

team-dev is a skill published in the GitHub repository cubha/claude-workflow-plugins (2 stars, last pushed 1mo ago), licensed MIT. It adds 78 tokens to every session and 2,069 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.