@maestria/pi

Structured workflows for Pi.

Install the Pi extension for four specialist subagents, workflow modes, and session-aware orchestration.

Get started Reference

npx maestria install pi

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

A native Pi extension.

4 specialist subagents

Pi registers the adventurer, architect, builder, and reviewer roles. Adventurer handles read-only diagnosis with the diagnose skill (on Pi, a diagnosis that must reproduce a failure goes through builder, since adventurer has no shell tool); architect handles phased plans with the plan skill; builder handles implementation and documentation.

Workflow modes

/fein runs the full pipeline, /sonar stays research-only, and /blitz takes the fast path.

Session tracking

The extension records subagent runs and handoff history in the session; `/maestria-status` summarizes the mode, delegated specialists, and recent handoffs.

Host-owned controls

Pi supplies the runtime; subagent dispatch needs the `@gotgenes/pi-subagents` extension, which the CLI installs. Read-only and lifecycle behavior follows the installed extension and host configuration.