@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.7.9
Published
Sep 14, 2026
Downloads
1,969/mo · 391/wk
Author
sozonome
License
MIT
Types
extension, skill
Size
81.2 KB
Dependencies
1 dependency · 3 peers
Pi manifest JSON
{
  "skills": [
    "./skills"
  ],
  "extensions": [
    "./dist/extension.mjs"
  ]
}

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 - specialist delegation, workflow modes, and maker/checker review - to Pi.

This package is part of the Maestria project. See VISION.md for the project vision, motivation, and scope.

Installation

# Recommended: via the maestria CLI (installs the peer dependency too)
pnpx maestria@latest install pi

# Manual: install the required peer dependency first, then the extension
pi install npm:@gotgenes/pi-subagents
pi install npm:@maestria/pi

Uninstall via pnpx maestria@latest uninstall pi. The @gotgenes/pi-subagents peer dependency is shared with other Pi extensions; only remove it separately if nothing else needs it.

What It Provides

  • 4 methodology skills - orchestrator dispatcher, global agent rules, handoff contract, and iteration limits, injected into every session.
  • 3 workflow modes - /fein (full pipeline), /sonar (research only), /blitz (fast implementation).
  • Compaction preservation - session state survives compaction with structured summaries.
  • Subagent dispatch - delegation to specialist subagents via the @gotgenes/pi-subagents peer package.
  • Maker/checker split - /review mode blocks destructive tools where Pi supports it.

Support / Platform Notes

  • Subagent dispatch depends on the @gotgenes/pi-subagents peer package; the maestria CLI installs it for you.
  • The methodology is advisory prompt guidance; the maker/checker split is enforced at the tool level only where Pi supports review-mode tool blocking.
  • Pi-specific: @maestria/omp is a separate package for Oh My Pi.

Documentation and Changelog

Contributing

See the contributing guide for repository conventions.

License

MIT