@maestria/pi

Maestria extension for the Pi coding agent

Packages

Package details

extensionskill

Install @maestria/pi from npm and Pi will load the resources declared by the package manifest.

npm repo report

$ pi install npm:@maestria/pi

Package: @maestria/pi
Version: 0.6.1
Published: Aug 3, 2026
Downloads: 2,867/mo · 650/wk
Author: sozonome
License: MIT
Types: extension, skill
Size: 160.2 KB
Dependencies: 0 dependencies · 3 peers

Pi manifest JSON

{
  "extensions": [
    "./dist/extension.mjs"
  ],
  "skills": [
    "./skills"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@maestria/pi

A Pi coding agent extension that brings Maestria's structured agent orchestration to Pi.

Features

4 Methodology Skills - Orchestrator dispatcher, global agent rules, handoff contract, and iteration limits - automatically injected into every session via Pi's standard skill system (SKILL.md files registered in pi.skills)
3 Workflow Modes - fein (full pipeline), sonar (research only), blitz (fast implementation)
Skill-Based Prompt Injection - Behavioral instructions injected via Pi's native skill mechanism, not custom event hooks. Skills are auto-discovered from the package manifest and loaded into the system prompt by Pi's resource loader - the standard pattern used by all major Pi extensions.
Compaction Preservation - Session state survives compaction with structured summaries
Subagent Dispatch - Delegation via @gotgenes/pi-subagents with 6-field handoff validation
Maker/Checker Split - Review mode blocks destructive tools. Dangerous bash patterns flagged.

Installation

Recommended: via maestria CLI

pnpx maestria@latest install pi

The CLI automatically installs both @gotgenes/pi-subagents (required peer dependency for subagent dispatch) and @maestria/pi in the correct order.

Alternative: manual Pi CLI

# Install required peer dependency first
pi install npm:@gotgenes/pi-subagents

# Install the extension
pi install npm:@maestria/pi

Uninstall

# Via maestria CLI (removes @maestria/pi)
pnpx maestria@latest uninstall pi

Note: @gotgenes/pi-subagents is a shared dependency that other Pi extensions may use. Only remove it if no other extensions need it:

pi uninstall @gotgenes/pi-subagents

Commands

Command	Description
`/fein <goal>`	Set workflow mode to full pipeline (recon → design → impl → review)
`/sonar <goal>`	Set workflow mode to research only (recon → design → stop)
`/blitz <goal>`	Set workflow mode to fast implementation (builder directly)
`/review <target>`	Enter review mode - blocks destructive tools, sets read-only toolset
`/restore-model`	Restore the original model and tools active before review mode
`/handoff <goal>`	Generate a structured handoff prompt for a new task context
`/review-model <model-id>`	Set which model to use when entering review mode
`/maestria-status`	Show current maestria session state including handoff history

Development

# Install dependencies
pnpm install

# Build
vp pack

# Test
vp test

# Format, lint, type-check
vp check

License

MIT