| name | sdd-team |
| description | Team-powered SDD workflow using Claude Code Agent Teams. Creates 3-teammate teams for parallel validation (GATE 2), implementation (Phase 8), and existing specs audit. Triggers: /sdd-team, /sdd-team audit, /sdd-team validate, /sdd-team implement.
|
| degree-of-freedom | high |
| allowed-tools | Task, SlashCommand, Read, Write, Edit, Glob, Grep, Bash(fd:*), Bash(rg:*), Bash(git:*), Bash(project-intel.mjs:*), Bash(pnpm:*), Bash(pytest:*), Bash(gh:*), AskUserQuestion, TeamCreate, TeamDelete, TaskCreate, TaskUpdate, TaskList, TaskGet, SendMessage |
SDD Team Orchestrator
Announce: "Using the SDD Team orchestrator for parallel agent-powered development."
If TeamCreate tool is NOT available → "Enable Agent Teams: set CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1, restart Claude Code." → STOP.
Known Constraints
| # | Constraint | Impact |
|---|
| 1 | One team per session | Must TeamDelete before creating next team |
| 2 | No teammate session resumption | Re-create team, skip completed tasks via .sdd/sdd-state.md |
| 3 | Cost: 3-5x vs subagents | Only use teams at complexity 4+; 1-3 defers to /sdd |
| 4 | Task status lag | Nudge idle teammates after 5+ min silence |
| 5 | Terminal split-pane | Works in iTerm2/Terminal.app only (not VS Code/Ghostty) |
Quick Reference
| Command | Action | Team Pattern |
|---|
| /sdd-team | Full SDD workflow (team-enhanced) | GATE 2 + Phase 8 teams |
| /sdd-team audit | Audit existing specs vs code | MapReduce audit team |
| /sdd-team validate | Run GATE 2 validation only | 3-validator team |
| /sdd-team implement | Run Phase 8 only | 3-lead pipeline team |
| /sdd-team status | Check SDD + team state | Status report |
$FEATURE: NNN-feature-name (e.g., 001-auth-oauth)
Intent Router
| Input | Intent | Route |
|---|
| (empty) or feature description | full_workflow | Phases 0-9 with team-enhanced GATE 2 + Phase 8 |
| "audit" or "audit existing" | audit | @workflows/audit-team.md |
| "validate" or "run validators" | validate | @workflows/validation-team.md |
| "implement" or "start coding" | implement | @workflows/implementation-team.md |
| "status" or "where am I" | status | See @templates/status-report.md |
| "continue" or "next" | continue | Resume from checkpoint |
Dynamic Team Sizing
Score complexity per @.claude/skills/sdd/references/complexity-detection.md:
| Factor | Pts | | Complexity | Action |
|---|
| Multiple integrations | +2 | | 1-3 | Defer to /sdd solo |
| New technology | +2 | | 4-7 | Standard: 3 teammates |
| DB schema changes | +1 | | 8-10 | Enhanced: 3 teammates + extra subagents |
| Auth/security | +2 | | | |
| Multi-user interactions | +1 | | | |
| External API deps | +2 | | | |
| Frontend + Backend | +1 | | | |
Phase Execution
Team-Enhanced Phases
| Phase | Enhancement | Workflow |
|---|
| GATE 2 (before Phase 5) | 3-teammate validation team | @workflows/validation-team.md |
| Phase 8 (/implement) | 3-teammate TDD pipeline | @workflows/implementation-team.md |
| /audit (standalone) | 3-teammate MapReduce audit | @workflows/audit-team.md |
Solo phases (0-6, 9) are imported verbatim from @references/existing-sdd-import.md.
Full Workflow Sequence
START → Complexity Check
[1-3] → Defer to /sdd (STOP)
[4-5] → Ask user if teams needed
[6+] → Phase 0 (discovery) + teams
Phase 0: Discovery (solo) → GATE 0
Phase 1-2: Product/Constitution (solo, optional)
Phase 3: Specification (solo) → GATE 1
Phase 4: Clarification (solo, if needed)
★ GATE 2: TEAM Validation ★ → Pass: 0 CRITICAL/HIGH → TeamDelete
Phase 5-6: Planning/Tasks (solo)
Phase 7: Audit (solo) → GATE 3
★ Phase 8: TEAM Implementation ★ → TDD per story → TeamDelete
Phase 9: Finalization (solo)
Validation Gates
| Gate | Criteria | On-Fail |
|---|
| GATE 0 | .sdd/discovery/ artifacts exist | Block Phase 3 |
| GATE 1 | spec.md exists, 0 [NEEDS CLARIFICATION], >= 2 ACs per story | Route to Phase 3/4 |
| GATE 2 | 0 CRITICAL, 0 HIGH across all validators | Route to Phase 3/4 |
| GATE 3 | audit-report.md PASS, 0 CRITICAL, 0 HIGH | Block Phase 8 |
State Management
See @references/state-management.md for state layers, flow, and recovery.
Team Spawn Patterns
See @references/tool-patterns.md for TeamCreate, TaskCreate, spawn, assign, messaging, and cleanup patterns.
Subagent Strategy
| Operation | Who Spawns | Subagent Types |
|---|
| Research (docs, APIs) | Teammates | Firecrawl, Ref MCP, Explore |
| Validation (domain checks) | Teammates | sdd-*-validator agents |
| Implementation (code) | Teammates | Explore, Research, Review |
| Coordination/Gates | Lead only | Status, Gate enforcement |
Status Report
See @templates/status-report.md for the status report template.
Error Handling
| Error | Detection | Recovery |
|---|
| Teams not enabled | TeamCreate unavailable | "Enable CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS" |
| Complexity too low | Score 1-3 | Defer to /sdd |
| No spec.md | /validate without spec | "Run /feature first" |
| GATE 2 FAIL | CRITICAL/HIGH findings | "Fix spec issues: [list]" |
| Audit FAIL | CRITICAL in report | "Fix issues: [list]" |
| [NEEDS CLARIFICATION] | Markers in spec | "Run /clarify first" |
| Teammate crash | No response after timeout | Re-spawn, reassign (max 2 retries) |
| Teammate repeat fail | 2+ crashes | Fallback to subagent-only |
| Team stuck | All idle, tasks pending | Nudge → reassign → unblock |
| State corruption | Invalid sdd-state.md | Rebuild from artifacts |
| TDD violation | Code before test | "Delete code, start with TDD" |
Quality Gates
See @.claude/skills/sdd/references/quality-gates.md for constitutional articles (I, III, IV, VI, VIII-XI).
Memory Auto-Sync
- New patterns →
memory/patterns.md
- Architecture decisions →
memory/decisions.md
- Lessons learned →
memory/learnings.md
Integration Points
/sdd-team extends /sdd — all solo phases imported verbatim; complexity 1-3 defers to /sdd- Six validators (in
.claude/agents/): sdd-frontend/data-layer/auth/api/architecture/testing-validator — invoked by teammates
- Team workflows: @workflows/validation-team.md, @workflows/implementation-team.md, @workflows/audit-team.md
Version
Version: 1.1.0 | Updated: 2026-02-07
- v1.1.0: Token optimization — compressed SKILL.md, extracted patterns to references
- v1.0.0: Initial SDD Team skill
