team-feature

Team Feature

Orchestrate parallel feature development with multiple implementer agents. Decomposes features into work streams with strict file ownership, manages dependencies, and verifies integration.

Pre-flight Checks

1. Verify CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 is set
2. Parse $ARGUMENTS:
   • <feature-description>: description of the feature to build
   • --team-size N: number of implementers (default: 2)
   • --branch: git branch name (default: auto-generated from feature description)
   • --plan-first: decompose and get user approval before spawning

Phase 1: Analysis

1. Analyze the feature description to understand scope
2. Explore the codebase to identify:
   • Files that will need modification
   • Existing patterns and conventions to follow
   • Integration points with existing code
   • Test files that need updates

Phase 2: Decomposition

1. Decompose the feature into work streams:

   • Each stream gets exclusive file ownership (no overlapping files)
   • Define interface contracts between streams
   • Identify dependencies between streams (blockedBy/blocks)
   • Balance workload across streams

2. If --plan-first is set:

   • Present the decomposition to the user:

     ## Feature Decomposition: {feature}
     
     ### Stream 1: {name}
     Owner: implementer-1
     Files: {list}
     Dependencies: none
     
     ### Stream 2: {name}
     Owner: implementer-2
     Files: {list}
     Dependencies: blocked by Stream 1 (needs interface from {file})
     
     ### Integration Contract
     {shared types/interfaces}
     

   • Wait for user approval before proceeding

   • If user requests changes, adjust decomposition

Phase 3: Team Spawn

1. If --branch specified, use Bash to create and checkout the branch:

   git checkout -b {branch-name}
   

2. Use TeamCreate tool to create the team with team_name: "feature-{timestamp}" and description
3. Spawn a team-lead agent to coordinate
4. For each work stream, use Agent tool to spawn a team-implementer:
   • name: implementer-{n}
   • subagent_type: "agent-teams:team-implementer"
   • prompt: Include owned files, interface contracts, and implementation requirements