sdd-team

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