@maestria/prime-agent

Maestria methodology for Prime Agent - specialist roles, orchestrator, global rules, and workflow modes as Agent Skills, plus a small Prime/Pi extension for mode commands and mode prompt injection

Packages

Package details

extensionskill

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

npm repohome report
$ pi install npm:@maestria/prime-agent
Package
@maestria/prime-agent
Version
0.3.2
Published
Aug 25, 2026
Downloads
713/mo · 354/wk
Author
sozonome
License
MIT
Types
extension, skill
Size
85.8 KB
Dependencies
0 dependencies · 0 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/prime-agent

Maestria's engineering methodology for Prime Agent, delivered as standard Agent Skills plus a small, verified Prime/Pi extension for workflow-mode commands.

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

Status / Support Boundary

Native candidate - skills and extension contract were reverified on 2026-08-13 against the current pinned Prime Agent reference, but runtime behavior in a live Prime session is not yet tested end to end. Native recursive-subagent (rlm) dispatch and JSON/RPC headless-mode integration are deferred (see below). Do not treat this package as a production support promise.

Installation

# Preferred: registers the published package with Prime (skills + extension)
prime-agent package install npm:@maestria/prime-agent

For skills-only installs, point Prime at the package's skills/ directory in settings, or copy/symlink the skill directories into a project or global skill location. See INSTALL.md for all installation and consumption options.

What It Provides

  • 7 specialist skills - adventurer, architect, builder, diagnose, planner, reviewer, writer.
  • Orchestration and rules skills - orchestrator, global-rules, handoff, iteration-limits.
  • Workflow mode skills - fein, sonar, blitz, loaded on demand by description matching or invoked explicitly as /skill:fein etc.
  • Executable extension - /fein, /sonar, /blitz, /mode-clear, and /maestria-status commands with session-scoped mode state.

Support / Platform Notes

  • Verified subset only: the extension covers mode commands and mode prompt injection. There is no recursive-subagent dispatch - "delegate to a specialist" loads the relevant skill and applies its methodology. JSON/RPC headless-mode integration is deferred.
  • Advisory, not enforced: skills, rules, and role prompts are guidance, not security enforcement. Prime has no skill-level tool-denial mechanism, so read-only roles state their role intent without claiming a runtime boundary.
  • Not a sandbox: Prime executes model-generated Python and project commands with your user permissions. Restrict use to trusted repositories, skills, and instructions.
  • No filesystem writes: nothing is written to ~/.pi or .prime/agent.
  • No extra dependencies: the extension uses only the Prime-bundled API; no pi package dependency is required.

Documentation and Changelog

Contributing

See the contributing guide for repository conventions.

License

MIT