Changelog
Entries apply to both @maestria/pi and @maestria/omp unless otherwise noted.
v0.7.14 (Pi) / v0.5.14 (OMP)
Section titled “v0.7.14 (Pi) / v0.5.14 (OMP)”September 23, 2026
- Project customization (
.maestria/workflow.mdthen.maestria/rules.md) loads as subordinate guidance; see the methodology changelog. create-pull-requestanddocs-updateskills install through the skills CLI with per-skill selection; see the CLI changelog.- Delegation wording clarified as contract-driven delegation; docs only, no behavior change. See the methodology changelog.
v0.7.13 (Pi) / v0.5.13 (OMP)
Section titled “v0.7.13 (Pi) / v0.5.13 (OMP)”September 18, 2026
- Consistent PR delivery contract with proportional documentation assessment; see the methodology changelog.
v0.7.12 (Pi) / v0.5.12 (OMP)
Section titled “v0.7.12 (Pi) / v0.5.12 (OMP)”September 17, 2026
- Stricter visual delivery evidence contract, with capture, PR-body publication, and readback as distinct stages; see the methodology changelog.
v0.7.11 (Pi) / v0.5.11 (OMP)
Section titled “v0.7.11 (Pi) / v0.5.11 (OMP)”September 16, 2026
- Defined when Sonar research is complete, with Blitz reusing valid context and switching routes for investigation or design work; see the methodology changelog.
v0.7.10 (Pi) / v0.5.10 (OMP)
Section titled “v0.7.10 (Pi) / v0.5.10 (OMP)”September 15, 2026
- Clarified rendered verification and visual delivery evidence, keeping required artifacts and verification gaps in handoffs; see the methodology changelog.
v0.7.9 (Pi) / v0.5.9 (OMP)
Section titled “v0.7.9 (Pi) / v0.5.9 (OMP)”September 15, 2026
- Internal consolidation; no user-facing behavior change and generated agent and skill output is unchanged.
v0.7.8 (Pi) / v0.5.8 (OMP)
Section titled “v0.7.8 (Pi) / v0.5.8 (OMP)”September 11, 2026
- Internal consolidation; no user-facing behavior change and generated agent and skill output is unchanged.
v0.7.7 (Pi) / v0.5.7 (OMP)
Section titled “v0.7.7 (Pi) / v0.5.7 (OMP)”September 8, 2026
- Stopped publishing generated JavaScript sourcemaps to reduce published package sizes; compiled runtime artifacts are unchanged.
v0.7.6 (Pi) / v0.5.6 (OMP)
Section titled “v0.7.6 (Pi) / v0.5.6 (OMP)”September 6, 2026
- Cross-cutting agent methodology update; see the methodology changelog.
v0.7.5 (Pi) / v0.5.5 (OMP)
Section titled “v0.7.5 (Pi) / v0.5.5 (OMP)”September 4, 2026
- Cross-cutting agent methodology update; see the methodology changelog.
v0.7.4 (Pi) / v0.5.4 (OMP)
Section titled “v0.7.4 (Pi) / v0.5.4 (OMP)”September 3, 2026
- Cross-cutting agent methodology update; see the methodology changelog.
v0.7.3 (Pi) / v0.5.3 (OMP)
Section titled “v0.7.3 (Pi) / v0.5.3 (OMP)”August 27, 2026
- Shared neutral mode and skill validation logic through the hybrid package topology.
v0.7.2 (Pi) / v0.5.2 (OMP)
Section titled “v0.7.2 (Pi) / v0.5.2 (OMP)”August 25, 2026
- Cross-cutting agent methodology update; see the methodology changelog.
v0.7.1 (Pi) / v0.5.1 (OMP)
Section titled “v0.7.1 (Pi) / v0.5.1 (OMP)”August 24, 2026
- Cross-cutting agent methodology update; see the methodology changelog.
v0.7.0 (Pi) / v0.5.0 (OMP)
Section titled “v0.7.0 (Pi) / v0.5.0 (OMP)”August 22, 2026
- Cross-cutting agent methodology update; see the methodology changelog.
v0.6.8 (Pi)
Section titled “v0.6.8 (Pi)”August 13, 2026
- Fix chain-mode
{previous}substitution so previous results containing$sequences are inserted literally, and abort already-spawned subagents when a later parallel spawn fails so none are orphaned.
v0.6.7 (Pi)
Section titled “v0.6.7 (Pi)”August 13, 2026
Effect v4 polling
Section titled “Effect v4 polling”- Use Effect v4 RC for cancellable subagent polling and structured parallel dispatch, so aborted or failed polls no longer leave sibling polling work running (ADR-CORE-017).
v0.6.6 (Pi) / v0.4.3 (OMP)
Section titled “v0.6.6 (Pi) / v0.4.3 (OMP)”August 13, 2026
- Pi: parallel subagent dispatch preserves successful results and aborts orphaned subagents on a partial failure.
- Cross-cutting agent methodology update; see the methodology changelog.
v0.5.6 (Pi) / v0.2.0 (OMP)
Section titled “v0.5.6 (Pi) / v0.2.0 (OMP)”July 21-22, 2026
- Cross-cutting agent methodology update; see the methodology changelog.
v0.5.5 (Pi)
Section titled “v0.5.5 (Pi)”July 21, 2026
Compact agent directives
Section titled “Compact agent directives”- Cross-cutting agent methodology update; see the methodology changelog.
v0.5.4 (Pi)
Section titled “v0.5.4 (Pi)”July 14, 2026
- Cross-cutting agent methodology update; see the methodology changelog.
v0.5.3 (Pi)
Section titled “v0.5.3 (Pi)”July 14, 2026
Mandatory PR description structure
Section titled “Mandatory PR description structure”- Cross-cutting agent methodology update; see the methodology changelog.
v0.5.2 (Pi)
Section titled “v0.5.2 (Pi)”July 14, 2026
- Cross-cutting agent methodology update; see the methodology changelog.
v0.5.1 (Pi)
Section titled “v0.5.1 (Pi)”July 14, 2026
- Cross-cutting agent methodology update; see the methodology changelog.
v0.4.1 (Pi)
Section titled “v0.4.1 (Pi)”July 11, 2026
Standard Pi/OMP skill mechanism for agent content
Section titled “Standard Pi/OMP skill mechanism for agent content”The orchestrator dispatcher prompt and global agent rules now load as platform skills (.md files in skills/). The old custom file-loading approach is removed.
Specialist agents registered with subagent system
Section titled “Specialist agents registered with subagent system”All 7 specialist agent types (adventurer, architect, builder, diagnose, planner, reviewer, writer) are now registered as proper agent types. Each specialist has the right tool permissions - read-only specialists (adventurer, architect, planner, reviewer, diagnose) can’t write files; builder and writer can.
v0.4.0 (Pi)
Section titled “v0.4.0 (Pi)”July 10, 2026
- Cross-cutting agent methodology update; see the methodology changelog.
v0.3.7 (Pi)
Section titled “v0.3.7 (Pi)”July 1, 2026
Code intelligence tool preference
Section titled “Code intelligence tool preference”- Cross-cutting agent methodology update; see the methodology changelog.
v0.3.1 (Pi)
Section titled “v0.3.1 (Pi)”June 27, 2026
Two new design principles
Section titled “Two new design principles”- Cross-cutting agent methodology update; see the methodology changelog.
v0.3.0 (Pi)
Section titled “v0.3.0 (Pi)”June 24, 2026
- Cross-cutting agent methodology update; see the methodology changelog.
v0.2.1 (Pi)
Section titled “v0.2.1 (Pi)”June 24, 2026
Single source of truth for agent directives
Section titled “Single source of truth for agent directives”- Cross-cutting agent methodology update; see the methodology changelog.
v0.2.0 - Initial release
Section titled “v0.2.0 - Initial release”June 23-24, 2026 (Pi) / July 22, 2026 (OMP)
Features
Section titled “Features”Initial release of @maestria/pi and @maestria/omp - portable extensions that bring maestria’s spec-driven orchestration, workflow modes, and specialist subagents to the Pi and OMP coding agents.
- 7 specialist agent types - adventurer, architect, builder, diagnose, planner, reviewer, writer with structured role definitions and tool permission boundaries
- 3 workflow modes -
fein(full pipeline with gates),sonar(research only),blitz(fast implementation), each routing to the appropriate subagent pipeline - Global rules injection - cross-cutting orchestration, delegation, and context-management rules injected into every session
- Session compaction preservation - structured state summaries survive compaction events, keeping task tracking and work-in-progress intact across turns
- Subagent dispatch - via
@gotgenes/pi-subagents(Pi) or nativetask()tool (OMP), with 6-field handoff validation /orchestrate,/review,/maestria-statuscommands - slash commands for dispatching work, requesting reviews, and inspecting extension state- Maker/checker enforcement - tool-level restriction prevents the orchestrator from implementing its own tasks
- 4 methodology skills - orchestrator dispatcher, global agent rules, handoff contract, and iteration limits
OMP-specific
Section titled “OMP-specific”- Built-in
task()dispatch - uses OMP’s nativetask()tool, no separate subagent package needed
v0.1.0 (Pi)
Section titled “v0.1.0 (Pi)”June 22, 2026
Features
Section titled “Features”Initial release of @maestria/pi - a portable Pi extension bringing spec-driven orchestration, workflow modes, and specialist subagents to the Pi coding agent.
- 8 specialist prompt templates - one orchestrator plus seven specialist subagents
- 3 workflow modes -
fein,sonar,blitz - Global rules injection via
before_agent_startevent - Session compaction preservation
- Subagent dispatch via
@gotgenes/pi-subagentswith 6-field handoff validation /orchestrate,/review,/maestria-statuscommands- Maker/checker enforcement via tool-call interception
- 2 methodology skills - handoff contract and iteration limits