Skip to content

maestria

Give your coding agent a team.

Method skills for recon, design, and diagnosis in the main loop, plus independent review, called in only when a task needs them. One method for OpenCode, Pi, Claude Code, Codex, Cursor, and more.

Get startedHow it works
npx maestria install

Works with npm, pnpm, yarn, bun, or deno.

Make every step intentional.

Pick a task. The main loop adds method skills and review only when they add information or reduce risk.

TaskAdd rate limiting to the upload API

  1. Main loop: Investigate, plan, implement
  2. Reviewer: Approved

Unfamiliar code with real trade-offs: method skills earn their place, then an independent check.

An agent that plans, builds, and grades its own work will approve its own mistakes. maestria separates the maker from the checker, hands context forward in structured briefs, and keeps each route as short as the task allows.

The smallest safe route

Small edits run directly. Method skills and review join only when they add information or reduce risk.

A second pair of eyes

The implementer never approves its own work. A reviewer who did not write it checks every meaningful change.

One method, native tools

The same method and rules on every host, built on each tool's own agents, skills, and plugins.

Meet the main loop and reviewer.

Each role has one job, one handoff, and one rule it never breaks. Read the full reference

  • Main loop

    Investigates, designs, implements, delivers

    Hands off
    Outcome delivery, review brief
    Rule
    Dispatches only reviewer
  • Reviewer

    Code review with quality gates

    Hands off
    Review verdict
    Rule
    Sees work fresh - independent

Install where you already work.

Run npx maestria install to detect your agents and pick from a list, or name a host directly.

npx maestria install opencode

Installs @maestria/opencode, a native plugin.

OpenCode setup guide