Skip to content

feat: create team-templates skill with reusable team configurations #21

@JacobPEvans-personal

Description

@JacobPEvans-personal

Parent

Part of #14 (epic: migrate workaround orchestration patterns to native Claude Agent Teams)

Summary

Create a team-templates skill that defines reusable team configurations for common workflows - code review, debugging, feature development, and multi-repo operations.

Problem

Every time a user wants an Agent Team, they must describe the team structure from scratch. Common patterns like "3-reviewer PR review" or "hypothesis-testing debug session" should be templates that can be invoked with minimal configuration.

Proposed Solution

Skill Structure

agent-teams-orchestrator/skills/
├── team-lifecycle.md
├── teammate-communication.md
└── team-templates.md          # NEW

Template Catalog

1. review-team - Multi-perspective code review

Roles: security-reviewer, performance-reviewer, test-reviewer, quality-reviewer
Models: 3x sonnet + 1x haiku
Mode: Delegate, no plan approval
Tasks: Review PR from assigned perspective, debate findings, synthesize

2. debug-team - Competing hypothesis debugging

Roles: 3-5 investigators (dynamic based on hypotheses)
Models: All sonnet
Mode: Delegate
Tasks: Each investigator tests one hypothesis, debate to disprove

3. feature-team - Parallel feature development

Roles: architect (plan approval), implementers (2-3), tester
Models: 1x opus (architect), 2-3x sonnet, 1x haiku (tester)
Mode: Delegate with plan approval
Tasks: Architect plans, implementers build in parallel, tester validates

4. repo-ops-team - Multi-repository operations

Roles: N repo-specialists (1 per repo group), 1 reporter
Models: All sonnet
Mode: Delegate
Tasks: Each specialist handles their repos, reporter aggregates

5. refactor-team - Large-scale refactoring

Roles: architect (plan approval), refactorers (2-4), reviewer
Models: 1x opus, 2-4x sonnet, 1x sonnet
Mode: Delegate with plan approval
Tasks: Architect designs, refactorers own file sets, reviewer cross-checks

Template Format

Each template defines:

  • Roles: Named teammate roles with responsibilities
  • Models: Recommended model per role
  • Mode: Delegate mode and plan approval settings
  • Task patterns: How work should be divided
  • Communication patterns: When to use write vs broadcast
  • File ownership: How to avoid conflicts
  • Sizing guidance: When to add/remove teammates

Usage

Templates are referenced by commands and skills:

Use the `review-team` template from the team-templates skill.
Spawn with PR #142 as context.

Acceptance Criteria

  • 5 team templates defined with complete specifications
  • Each template includes model routing, task patterns, and communication guidance
  • Templates are actionable (not just documentation)
  • File ownership patterns prevent conflicts
  • Token cost estimates per template
  • Passes markdownlint and token limit validation

Dependencies

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions