OpenCode Agents

A collection of specialized agents for structured software development workflows. These agents coordinate to take projects from initial brief through implementation, testing, and documentation.

Quick Start

Each agent is defined in the agent/ directory with its purpose, workflow, and configuration. Use them as reference patterns for setting up your own agent orchestration system.

Agent Categories

Primary Agents

Coordinate complex workflows and orchestrate subagents.

• brief-agent - Creates comprehensive project briefs by gathering context from codebase and user input
• spec-agent - Transforms briefs into detailed implementation specifications
• orchestration-agent - Coordinates delivery workflow through specialized subagents

Development Subagents

Handle specific aspects of the development lifecycle.

• code-writer - Implements features from spec acceptance criteria
• test-writer - Writes pytest tests covering acceptance criteria and edge cases
• code-reviewer-lite - First-pass code review with PASS/FAIL verdict
• code-reviewer-pro - Second opinion review when lite doesn't resolve issues

Documentation Subagents

Manage documentation creation and maintenance.

• doc-writer - Creates/updates documentation for implemented features
• doc-reviewer - Reviews documentation quality with actionable feedback
• script-doc-indexer - Maintains documentation registry for scripts
• inline-doc-improver - Improves Python docstrings and inline documentation

Analysis Subagents

Provide specialized analysis and insights.

• contract-analyzer - Discovers input/output contracts for components
• acceptance-criteria-refiner - Converts criteria to testable GIVEN/WHEN/THEN format
• test-strategy-writer - Generates test strategies (not code)
• pseudocode-writer - Creates pseudocode for complex algorithms
• brief-compliance-reviewer - Verifies specs cover briefs without scope creep

Utility Subagents

Handle common development tasks.

• script-reader - Analyzes Python scripts for architecture and patterns
• doc-reader - Discovers and analyzes documentation via registry
• config-parameter-agent - Retrieves parameter values and documentation
• junior-dev - Simple, well-defined tasks with clear reporting
• bug-reporter - Systematic bug analysis and reporting

Quality Assurance Subagents

Identify technical debt and scope issues (read-only analysis).

• redundancy-checker - Finds dead code, unused parameters, and technical debt
• yagni-checker - Detects scope creep and over-engineering violations

Insights Subagents

Analyze performance and optimization data.

• insights-data-builder - Builds data marts from raw backtest data
• insights-top-runs - Analyzes top performing runs and parameter differences
• insights-run-deep-dive - Deep-dive analysis of specific run performance
• insights-confidence-evolution - Analyzes confidence evolution patterns

Templates

Standardized request templates in templates/ ensure consistent agent inputs:

• code-write-request.md - Feature implementation requests
• test-write-request.md - Test creation requests
• doc-write-request.md - Documentation updates
• code-review-request.md - Code review requests
• bug-report-request.md - Bug analysis reports

Usage Pattern

1. Brief Creation - Use brief-agent to gather requirements and context
2. Spec Development - Use spec-agent to create detailed specifications
3. Implementation - Use orchestration-agent to coordinate delivery through subagents
4. Quality Assurance - Code reviews, testing, and documentation updates

Each agent follows defined workflows with clear inputs, outputs, and verification steps. See individual agent files for detailed usage instructions.