# Changelog

# Changelog

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

## v0.5.6 (Pi) / v0.2.0 (OMP)

_July 21-22, 2026_

- **Pi:** Sync workflow mode commands (fein/sonar/blitz) through canonical source pipeline.

## v0.5.5 (Pi)

_July 21, 2026_

### Compact agent directives

Agent directives compressed to cut context usage by ~38% on the orchestrator prompt without removing rules or intent. Shared specialist rules now live once in global rules instead of being repeated per specialist.

## v0.5.4 (Pi)

_July 14, 2026_

### Structured assumption tagging

Adventurer and architect outputs now require `[verified]` or `[inferred]` tags on every assumption.

### Deterministic agents preferred

New CRITICAL RULE mandates defined output contracts before delegating. Open-ended exploration must be scoped with time and resource limits.

### Cognitive hygiene for delegation

The orchestrator now has a 5-trap pre-flight checklist to catch weak delegation prompts.

### Outcome specs over activity specs

Delegation now prefers specifying what to achieve over how to achieve it.

### Experiment framing, parallel speculation, incidental findings, first-principles decomposition

Additional methodology improvements across all specialist agents.

## v0.5.3 (Pi)

_July 14, 2026_

### Mandatory PR description structure

COMMIT PROTOCOL step 7 now requires a numbered list of PR description sections: Summary, ## Changes, ## Testing, and ## Breaking Changes.

## v0.5.2 (Pi)

_July 14, 2026_

### Aligned orchestrator push rules with Branch Discipline

The `question()` call when landing on main/master is removed. The commit protocol now auto-checkouts a feature branch instead of asking.

### Improved Work Results output format

Restructured from a 3-part narrative to a lean table-first format with change-type prefixes (+/~/-), breaking change markers (!), and test file annotations ((test)).

## v0.5.1 (Pi)

_July 14, 2026_

### Structured work results are now mandatory

After every task, the agent must produce a `## Changes` summary table instead of a free-form description.

### Documentation audit before every commit

The agent now checks internal docs, the user-facing docs site, the user-facing changelog, and changesets before committing.

## v0.4.1 (Pi)

_July 11, 2026_

### 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

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)

_July 10, 2026_

### Multi-lens review swarm

The orchestrator can now dispatch parallel reviewers with different focus areas (Security, Architecture, Performance, UX, General). Issues are categorized [fix]/[dismiss]/[escalate].

### Autonomous commit protocol

Commit is fully autonomous - agent reads git log, composes correct conventional commit message, commits without asking. Push is automatic on feature branches, asks only on main/master.

### Eliminate questions - autonomous philosophy

Agents now exhaust data, document assumptions, and proceed instead of asking for permission. Mid-phase questions eliminated across all specialists.

### Review methodology improvements

- **Observation over reasoning** - reviewer now prioritizes running code over logical argument.
- **Review triage pipeline** - issues categorized and validated with conservative conflict resolution.

## v0.3.7 (Pi)

_July 1, 2026_

### Code intelligence tool preference

Agents now prefer code intelligence tools (MCP, CLI, or other) before falling back to grep and read when exploring the codebase.

## v0.3.1 (Pi)

_June 27, 2026_

### Two new design principles

Agents now check from first principles before adopting existing patterns, and check for existing solutions before building from scratch.

## v0.3.0 (Pi)

_June 24, 2026_

### Project workflow configuration (.maestria/)

Ships the `.maestria/` project workflow protocol. Projects using Maestria's agent directives can now define `.maestria/workflow.md` for custom delegation sequencing and `.maestria/rules.md` for project-specific rules. The orchestrator loads these via `@adventurer` delegation.

### Effort anthropomorphism guard and writing style guidance

The orchestrator and all specialists now include explicit guardrails against two common failure modes:

- **Don't anthropomorphize effort** - A new Critical Rule tells the dispatcher that thinking "that analysis would be too much work" is a category error for a machine that only routes. The same principle is instilled in all specialists via the global agent rules.

## v0.2.1 (Pi)

_June 24, 2026_

### Single source of truth for agent directives

Agent prompts and global rules now live in one canonical location (`packages/core/agent-directives/`) and sync automatically to all platform plugins. The `scripts/sync-all` and `scripts/check-sync` tools handle the pipeline.

## v0.2.0 - Initial release

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

### 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 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

### OMP-specific

- **Built-in `task()` dispatch** - uses OMP's native `task()` tool, no separate subagent package needed

## v0.1.0 (Pi)

_June 22, 2026_

### 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_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