Skip to content

Changelog

Entries apply to both @maestria/pi and @maestria/omp unless otherwise noted.

September 23, 2026

  • Project customization (.maestria/workflow.md then .maestria/rules.md) loads as subordinate guidance; see the methodology changelog.
  • create-pull-request and docs-update skills 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.

September 18, 2026

  • Consistent PR delivery contract with proportional documentation assessment; see the methodology changelog.

September 17, 2026

  • Stricter visual delivery evidence contract, with capture, PR-body publication, and readback as distinct stages; see the methodology changelog.

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.

September 15, 2026

  • Clarified rendered verification and visual delivery evidence, keeping required artifacts and verification gaps in handoffs; see the methodology changelog.

September 15, 2026

  • Internal consolidation; no user-facing behavior change and generated agent and skill output is unchanged.

September 11, 2026

  • Internal consolidation; no user-facing behavior change and generated agent and skill output is unchanged.

September 8, 2026

  • Stopped publishing generated JavaScript sourcemaps to reduce published package sizes; compiled runtime artifacts are unchanged.

September 6, 2026

September 4, 2026

September 3, 2026

August 27, 2026

  • Shared neutral mode and skill validation logic through the hybrid package topology.

August 25, 2026

August 24, 2026

August 22, 2026

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.

August 13, 2026

  • 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).

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.

July 21-22, 2026

July 21, 2026

July 14, 2026

July 14, 2026

July 14, 2026

July 14, 2026

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.

July 10, 2026

July 1, 2026

June 27, 2026

June 24, 2026

June 24, 2026

Single source of truth for agent directives

Section titled “Single source of truth for agent directives”

June 23-24, 2026 (Pi) / July 22, 2026 (OMP)

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 native task() tool (OMP), with 6-field handoff validation
  • /orchestrate, /review, /maestria-status commands - 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
  • Built-in task() dispatch - uses OMP’s native task() tool, no separate subagent package needed

June 22, 2026

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_start event
  • Session compaction preservation
  • Subagent dispatch via @gotgenes/pi-subagents with 6-field handoff validation
  • /orchestrate, /review, /maestria-status commands
  • Maker/checker enforcement via tool-call interception
  • 2 methodology skills - handoff contract and iteration limits