# Agents

# Agents

`@maestria/opencode` provides one manager agent (`@orchestrator`) and 7 specialist subagents. Each agent has a focused domain, clear methodology, and specific permissions.

## The Orchestration Model

The `@orchestrator` decomposes complex tasks into atomic units, delegates to specialists via `task()`, integrates results, and verifies completion. Specialists handle one domain each — exploration, design, implementation, debugging, planning, review, or documentation.

## Agent Reference

| Agent           | Mode       | Role                                  | Key Permissions                 |
| --------------- | ---------- | ------------------------------------- | ------------------------------- |
| `@orchestrator` | `all`      | Manager — delegates, never implements | `edit: deny`, `task: * allow`   |
| `@adventurer`   | `subagent` | Codebase reconnaissance               | `edit: deny`, `bash: * ask`     |
| `@architect`    | `subagent` | Architecture decisions                | `edit: deny`, `webfetch: allow` |
| `@builder`      | `subagent` | Focused implementation                | `edit: allow`, `bash: * ask`    |
| `@diagnose`     | `subagent` | Systematic debugging                  | `edit: ask`, `bash: * ask`      |
| `@planner`      | `subagent` | Implementation plans                  | `edit: ask`, `webfetch: allow`  |
| `@reviewer`     | `subagent` | Code review                           | `edit: deny`                    |
| `@writer`       | `subagent` | Documentation                         | `edit: allow`                   |

## Pipeline Flow

A typical multi-step task follows this flow through the agent system:

```
@orchestrator (manager)
  ├─ @adventurer  → Explore codebase, map dependencies
  ├─ @architect   → Design approach, evaluate options
  ├─ @planner     → Create phased implementation plan
  ├─ @builder     → Implement changes
  └─ @reviewer    → Review for correctness and quality
```

Each agent hands off to the next. The orchestrator integrates results and verifies completion.

## Agent Details

[Orchestrator](/opencode/agents/orchestrator/)
  [Adventurer](/opencode/agents/adventurer/)
  [Architect](/opencode/agents/architect/)
  [Builder](/opencode/agents/builder/)
  [Diagnose](/opencode/agents/diagnose/)
  [Planner](/opencode/agents/planner/)
  [Reviewer](/opencode/agents/reviewer/)
  [Writer](/opencode/agents/writer/)