Quick Start

Once installed, all agents and rules load automatically in every session.

Choose the workflow before choosing the orchestrator

maestria adds coordination and review sessions. For small changes or expensive, slow models, direct execution or one specialist is often better. Read When to use maestria first.

Start a Session

Launch OpenCode as usual. The plugin loads with it.

Delegate to a Specialist

Call any specialist directly:

@adventurer Explore the auth module and trace the login flow.

For unfamiliar, multi-file, or high-risk work, hand it to the orchestrator:

@orchestrator I need to add rate limiting to the API. Plan and implement it.

The orchestrator decomposes the task, delegates to specialists, and integrates the results. It routes work through thinker, worker, verifier roles: fein for the full pipeline, sonar for research only, blitz for fast implementation. See the Agent Reference.

For longer autonomous runs, the independent OpenCode Goal Plugin adds Codex-style goal mode; maestria neither requires nor activates it.

Next Steps

• Agent Reference - Full docs for all 8 agents
• Workflow Patterns - Orchestration and pipeline patterns