Contributing

For repository setup, changesets, and pull requests, see the Contributing Guide. For shared methodology changes, follow the Canonical Source Workflow.

Package Boundary

@maestria/pi pairs a runtime extension with generated agent and skill resources. The extension owns Pi lifecycle hooks, mode state, compaction, commands, deployment, and subagent dispatch. Shared prompts and global rules remain in packages/core/agent-directives/; runtime changes belong in packages/pi/src/.

Change Shared Methodology

Edit the canonical source in packages/core/agent-directives/ (including skills/ for the bundled create-pull-request and docs-update skills), never generated files under agents/ or skills/, then regenerate and verify:

scripts/sync-all
scripts/check-sync
pnpm --filter @maestria/pi test

Platform transforms should stay small. Pi adapts specialist names and tool conventions at its projection boundary; it does not own a second copy of shared methodology.

Validate

pnpm --filter @maestria/pi build
pnpm --filter @maestria/pi validate
pnpm --filter @maestria/pi test

The separate OMP integration uses the portable package; see its guide for host-specific behavior.