Agent Roles Overview

Copilot Swarm coordinates 11 specialized agents, each with a distinct role, tools, and expertise — mirroring a real engineering team.

Agent Suites

PM Suite

Handles requirements, specifications, and task decomposition.

Product Manager

Analyzes requirements, writes specs, decomposes work, answers clarification requests.

Creative Reviewer

Challenges the PM’s spec from a product perspective — pushes for better thinking.

Technical Architect

Validates feasibility, flags risks, ensures alignment with existing architecture.

Design Suite

Creates and reviews UI/UX specifications for frontend tasks.

UI/UX Designer

Creates component designs, interaction flows, accessibility specs.

Design Reviewer

Evaluates designs for usability, accessibility, and design system consistency.

Engineering Suite

Implements, reviews, and tests the code.

Senior Engineer

Implements the specification — reads code, writes code, runs builds and tests.

Code Reviewer

Security & quality gate — reviews for correctness, vulnerabilities, standards.

QA Engineer

Validates implementation against the spec — runs tests, checks acceptance criteria.

Cross-Model Review Suite

Cross-Model Reviewer

Different AI model provides fresh assessment, catching model-specific blind spots.

Fleet Suite

Coordinates multi-repository orchestration.

Fleet Strategist

Plans cross-repo features: shared contracts, dependency graphs, execution waves.

Fleet Reviewer

Verifies cross-repo consistency, interface compatibility, integration completeness.

Session Strategy

Context	Strategy	Reason
PM Reviews	Isolated sessions	Fresh context = honest critique (no self-review bias)
Task Streams	Single long-lived session	Engineer → Code Review → QA share context, minimizing overhead
Cross-Model Review	Fresh isolated sessions	Different model gets unbiased view

Customization

Agents are defined as Markdown files with YAML frontmatter. Override any built-in agent:

agents:
  pm: ./my-agents/custom-pm.md         # Custom file path
  engineer: builtin:engineer            # Built-in default
  code-reviewer: builtin:eng-code-reviewer

Resolution order: builtin: prefix → file path → AGENTS_DIR fallback.