team

You orchestrate multi-agent teams across all AIWG providers. On Claude Code, teams run natively via the Task tool. On all other providers, you emulate team execution through aiwg mc (Mission Control). Team definitions live in agentic/code/frameworks/sdlc-complete/teams/.

Triggers

Alternate expressions and non-obvious activations (primary phrases are matched automatically from the skill description):

• "spin up a team" → team run with named team
• "who's on the security review team" → team info
• "what teams do I have" → team list
• "run the greenfield team on this task" → team run greenfield "<task>"

Trigger Patterns Reference

Behavior

When triggered:

1. Parse the subcommand:

   • run <team-name> "<task>" — execute team against a task
   • list — list all available teams from the manifest
   • info <team-name> — show team composition and use cases

2. Detect provider:

   • Claude Code (CLAUDE_CODE_VERSION set) → native Task-tool dispatch
   • All other providers → emulate via aiwg mc dispatch

3. Run the appropriate command:

   bash
   1# Run a team on a task
   2aiwg team run sdlc-review "Review the SAD at .aiwg/architecture/sad.md"
   3
   4# Run with provider override
   5aiwg team run security-review "Audit auth module" --provider cursor
   6
   7# List all teams
   8aiwg team list
   9
   10# Inspect a team
   11aiwg team info greenfield

4. Report execution progress:

   • Native (Claude Code): reports inline as agents complete
   • Emulated (mc): reports mission IDs and tracks via aiwg mc status

Team Definitions

Teams are defined as JSON files in agentic/code/frameworks/sdlc-complete/teams/. Built-in teams:

Team Definition Format

yaml
1# .aiwg/teams/my-team.yaml  (project-local override)
2name: Custom Review Team
3slug: custom-review
4description: Tailored review for domain-specific concerns
5agents:
6  - agent: security-architect
7    role: lead
8    responsibilities:
9      - Security threat model
10      - Auth design review
11  - agent: test-architect
12    role: contributor
13    responsibilities:
14      - Test coverage gaps
15      - Integration risks
16  - agent: technical-writer
17    role: reviewer
18    responsibilities:
19      - Clarity and consistency
20dispatch: parallel

Execution Modes

Native (Claude Code)

Agents launch as parallel Task tool calls in a single message. Each agent runs independently with its assigned prompt, and results are collected and synthesized.

Emulated (All Other Providers)

bash
1# Steward emulates by dispatching via Mission Control
2SESSION=$(aiwg mc start --name "team-run-$(date +%s)")
3aiwg mc dispatch $SESSION "security-architect: <task>" --completion "Review complete"
4aiwg mc dispatch $SESSION "test-architect: <task>" --completion "Review complete"
5aiwg mc watch $SESSION

Examples

Example 1: Run a review team

User: "Run the security review team on the auth module"

Extraction: team run security-review on the auth module

Action:

bash
1aiwg team run security-review "Review src/auth/ for security vulnerabilities, focusing on token handling and session management"

Response (Claude Code, native):

Launching security-review team (3 agents, parallel)...
  security-architect: reviewing...
  security-auditor:   reviewing...
  privacy-officer:    reviewing...

Results collected. 2 critical findings, 4 recommendations.
Full report: .aiwg/working/team-runs/security-review-20260401-143022.md

Example 2: List teams

User: "What teams do I have available?"

Action:

bash
1aiwg team list

Response:

Available teams (7):
  api-development   API design, documentation, test generation
  full-stack        Feature implementation across layers
  greenfield        New project inception and architecture
  maintenance       Refactoring, debt reduction, upgrades
  migration         Database or platform migration planning
  sdlc-review       Architecture, requirements, and test review
  security-review   Threat modeling, security audit, privacy review

Example 3: Inspect team composition

User: "Who is on the sdlc-review team?"

Action:

bash
1aiwg team info sdlc-review

Response:

Team: sdlc-review
Description: Architecture, requirements, and test review
Dispatch: parallel

Agents:
  architecture-designer  [lead]        Architecture quality and pattern review
  requirements-analyst   [contributor] Requirements traceability and completeness
  test-architect         [contributor] Testability and coverage gaps
  technical-writer       [reviewer]    Clarity and documentation quality

Use cases:
  - SAD review before Architecture Baseline Milestone
  - Elaboration phase gate check
  - ADR peer review

Clarification Prompts

If the user names a task without a team:

• "Which team should I run? Available: sdlc-review, security-review, api-development, full-stack, greenfield, maintenance, migration"

If the team name is ambiguous:

• "Did you mean security-review or sdlc-review?"

References

• @$AIWG_ROOT/src/cli/handlers/team.ts — Team command handler
• @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/teams/ — Built-in team definitions
• @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/teams/manifest.json — Team manifest
• @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/teams/schema.json — Team definition schema
• @$AIWG_ROOT/docs/cli-reference.md — CLI reference