Agents
Agent Team
Complete catalog of Gem Team's specialist agents.
Orchestrator
Coordinates the workflow, delegates work, tracks plans, and enforces verification gates. Runs the Phase 0–4 pipeline. Escalates complexity when design smells (rigidity, fragility, viscosity) are detected. Never executes work directly: routes everything to specialist agents.
Core Agents
| Agent | Role |
|---|---|
| Researcher | Explores codebase patterns, dependencies, architecture, and docs. 5 modes (scan, deep, audit, trace, question) with budget controls. |
| Planner | Creates DAG-based execution plans with task decomposition, wave scheduling, dependency mapping, risk analysis, and acceptance criteria. Pre-checks for design smells (rigidity, fragility, immobility, viscosity) before decomposition. |
| Implementer | Implements features, fixes, and refactors using TDD (Red-Green-Refactor). Tests 6 categories: happy path, invariants, boundaries, error paths, input variation, state transitions. Bug-fix mode requires diagnosis. |
Quality & Review Agents
| Agent | Role |
|---|---|
| Reviewer | Reviews implementation quality, security, maintainability, contracts, and test coverage. Plan validation. OWASP + secrets + mobile 8-vector (keychain, cert pinning, deep links, biometric auth) scan. Accessibility (a11y) audit. |
| Critic | Reviews PRD requirements for inconsistencies. Challenges assumptions, finds edge cases, flags over-engineering. Evaluates decomposition, dependencies, complexity. Detects design smells: coupling, layer violations, hidden deps, shortcut temptation. |
| Debugger | Root-cause analysis, stack trace diagnosis, regression bisection, error reproduction. Uses the "Prove-It" pattern (write a reproduction test first to confirm the bug before fixing). Never implements fixes. |
| Browser Tester | E2E browser checks, UI flow validation, visual regression, console/network capture, a11y audit. |
| Code Simplifier | Removes dead code, reduces cyclomatic complexity, consolidates duplicates, improves naming. Applies design smell patterns (Strategy, Interface Segregation, Layer Separation). Follows Chesterton's Fence principle. |
Specialized Agents
| Agent | Role |
|---|---|
| DevOps | Infrastructure deployment, CI/CD pipelines, container management (Docker/K8s). Approval gates for prod. Health checks, rollback. Mobile deployment. |
| Documentation | Technical docs, READMEs, API docs, diagrams, walkthroughs. PRD authoring and maintenance. Context envelope updates. |
| Designer | UI/UX layouts, themes, color schemes, design systems. Design movements. 9-section DESIGN.md output with agent prompt guide. WCAG 2.1 AA. |
| Implementer-Mobile | Mobile TDD for React Native, Expo, Flutter. Platform-specific code. Bug-fix mode. |
| Designer-Mobile | Mobile UI/UX for iOS (HIG) and Android (Material 3). Safe areas, touch targets, platform-specific specs. |
| Mobile Tester | Mobile E2E with Detox, Maestro, Appium. iOS + Android. Gesture, lifecycle, push notifications. Performance testing. Device farm support. |
| Skill Creator | Extracts reusable SKILL.md files from high-confidence patterns. Creates scripts, references, and cross-linked assets. |
Model Routing
| Agent Tier | Recommended Model | Use Case |
|---|---|---|
| Default | Fast / flash (gpt-4o-mini, claude-3.5-haiku, gemini-2.5-flash) | Implementation, docs, research, simple checks |
| Planner, Debugger, Critic, Reviewer | Strong / pro (claude-4, gpt-5.1-pro, gemini-2.5-pro) | Planning, analysis, compliance, high-risk verification |
Configurable in .gem-team.yaml. Swap with equivalent models from your provider.