Pipeline composition
Route work through focused stages instead of asking one context to do everything.
Maestria
MAESTRIA / METHODOLOGY LAYER
Make the work deliberate.
A portable harness for AI coding agents. Route complex work through specialists, structured handoffs, and independent review.
Thinker
Adventurercontext mappedrecon report
Architectapproach selecteddecision record
Plannerscope boundedimplementation plan
Worker
Builderartifact producedimplementation + tests
Verifier
Reviewerindependent checkreview verdict
Workflow
ThinkAdventurer · recon reportdone
RouteOrchestrator → Builderrouted
BuildBuilder · implementation + testsready
ReviewReviewer · verdict pendingqueued
Inspector
HandoffBuilder → Reviewer
Verdictartifact accepted
Boundarymaker != checker
Terminationverifier accepts
8SPECIALISTS
3COGNITIVE ROLES
1ORCHESTRATOR
0VENDOR LOCK-IN
01 / THE METHOD
Structure beats improvisation.
Maker/checker split
The builder produces; the reviewer sees it fresh.
Platform independence
Methodology stays consistent while each platform uses native primitives.
02 / SPECIALISTS
The conductor is not the crew.
Orchestrator
Routes tasks to specialists, manages commit protocol
The dispatcher that never implements. Routes every task to the right specialist, enforces maker/checker split, and manages the commit protocol.
- Scope
- Dispatch only - never implements
- Artifact
- Route assignments, commit protocol
- Constraint
- Maker/checker split enforced
Adventurer
Codebase reconnaissance, deep code understanding
Maps unknown territory so downstream specialists can work with full context. Explores code paths, traces dependencies, and produces structured reconnaissance reports.
- Scope
- Unfamiliar code territory
- Artifact
- Reconnaissance report
- Constraint
- Read-only - no edits
Architect
Architecture decisions, trade-off analysis, ADRs
Makes architecture decisions systematically. Clarifies the problem, presents options with trade-offs, and documents decisions as Architecture Decision Records.
- Scope
- Approach selection, trade-offs
- Artifact
- Decision record (ADR)
- Constraint
- Decisions documented, not coded
Builder
Focused implementation, single-task execution
Handles exactly one atomic task per invocation. Reads context, edits minimally, verifies with tests, and reports what changed and why.
- Scope
- One atomic task
- Artifact
- Implementation + tests
- Constraint
- Never reviews its own work
Diagnose
Systematic bug tracing, root cause analysis
Traces bugs systematically from error to source, source to git history, and history to blast radius. Finds root cause and all similar problems in the codebase.
- Scope
- Regressions, incidents
- Artifact
- Root cause analysis
- Constraint
- Root cause before fix
Planner
Implementation plans with phased milestones
Creates implementation plans with goals, phased milestones, atomic tasks, verification criteria, and rollback points for complex features.
- Scope
- Complex, multi-step features
- Artifact
- Phased implementation plan
- Constraint
- Plan first, build later
Reviewer
Code review with quality gates
Runs one general review for quality, correctness, security, and maintainability, adding specialist lenses only for matching security, performance, architecture, or UX risk. Preserves blind review, lens exclusivity, observation over reasoning, and [fix]/[dismiss]/[escalate] triage. Enforces the maker/checker split.
- Scope
- Pre-merge quality gates
- Artifact
- Review verdict
- Constraint
- Sees work fresh - independent
Writer
Documentation following structured patterns
Writes documentation following structured patterns. Covers purpose, usage, and details with progressive disclosure and clear, human-readable prose.
- Scope
- Documentation and prose
- Artifact
- Structured docs
- Constraint
- Follows the source of truth
03 / ADAPTERS
One methodology. Native primitives.
@maestria/opencode8 specialized agents with global rules injected into every session.@maestria/kimi-code8 specialized skills with swarm-aware orchestration and no build step.@maestria/cursorSpecialist agents, orchestrator skill, and workflow commands for Cursor IDE and CLI.@maestria/pi & @maestria/omp7 specialist subagents with spec-driven orchestration for Pi and Oh My Pi.@maestria/hermesMethodology layer for Hermes Agent: 7 specialists, pipeline, and mode system.Shared ecosystemOptional companion tooling: CodeGraph indexing and RTK.
04 / DOCUMENTATION
Start with the system, then choose your platform.
Core
How It WorksThe dispatcher, seven specialists, and the staged pipeline.Pipeline & RolesThinker, worker, and verifier roles and the maker/checker split.Specialist ReferenceAll eight agents: scope, artifact, and constraint for each.When to UseDecide between direct execution, a specialist, or the full pipeline.Adapters
@maestria/opencodeOpenCode plugin with 8 agents and global rules.@maestria/kimi-codeKimi Code plugin with 8 declarative skills.@maestria/cursorCursor IDE and CLI plugin with specialist agents.@maestria/pi & @maestria/ompPi and Oh My Pi orchestration through subagents.@maestria/hermesHermes Agent methodology layer and mode system.