Skip to content
Maestria

Portable Pi Engineering Workflows

Extend the Pi coding agent with Maestria workflow modes, 7 specialist subagents, and disciplined orchestration - configured in seconds.
Get StartedView on GitHub

How It Works

Section titled “How It Works”
  1. Install the extension - pnpx maestria@latest install pi or add to pi.json
  2. Extension activates - Pi loads the extension, auto-discovers 4 methodology skills (orchestrator dispatcher, global agent rules, handoff contract, iteration limits) via the package manifest and injects them into every session’s system prompt. Registers mode commands (/fein, /sonar, /blitz), and activates 7 specialist subagents.
  3. Mode commands drive the pipeline - /fein (full pipeline), /sonar (research), /blitz (fast impl) - each activates the right subagents in sequence
  4. Orchestrator dispatches - The orchestrator subagent decomposes work, delegates to specialists, and enforces phase gates
  5. Session tree tracks state - Each subagent invocation records its parent task ID, preserving the full session tree across turns

Quick Install

Section titled “Quick Install”
Terminal window
pnpx maestria@latest install pi

The maestria CLI automatically handles peer dependencies. Alternatively:

Terminal window
pi install npm:@maestria/pi

The extension is fully self-configuring - Pi auto-discovers its methodology skills, commands, and subagent tools from the package manifest. No manual config editing needed.

Installation Guide →

Explore the Docs

Section titled “Explore the Docs”
Getting StartedInstallation, setup, and your first session with the Pi extension.
Pi ReferenceCommands, subagent dispatch modes, review mode, and session management.
ChangelogVersion history and release notes.
ContributingProject structure and how to extend the plugin.