# Changelog

# Changelog

## v0.5.1

_July 14, 2026_

### Mandated work results format

The structured `## Changes` summary table after builder tasks is now a
hard requirement enforced by a non-negotiable CRITICAL RULE. This replaces
the previous suggested behavior with a mandated format.

### Mandated documentation audit before commits

The documentation audit step before every commit is now explicitly required,
covering four categories: internal docs, user-facing docs site, user-facing
changelog, and changesets.

## v0.4.1

_July 11, 2026_

### Architecture refactor: skill-based injection + pi-subagents agent registration

Complete re-architecture of how maestria behavioral content flows into Pi sessions:

**Standard Pi skill mechanism:** The orchestrator dispatcher prompt and global agent rules now ship as Pi `SKILL.md` files in `skills/`, auto-discovered from the `pi.skills` manifest field and injected by Pi's resource loader -- the same standard pattern used by pi-web-access, pi-messenger, pi-intercom, and other major Pi extensions. The old `before_agent_start` + `readFileSync` approach is removed.

**Pi-subagents agent type registration:** The 7 specialist prompts (adventurer, architect, builder, diagnose, planner, reviewer, writer) are registered with `@gotgenes/pi-subagents` as proper agent types via `.md` files with YAML frontmatter, deployed to `~/.pi/agent/agents/` at extension startup. Each specialist gets role-specific tool isolation via `tools` allowlists in the frontmatter (builder/writer have write access, all others read-only), enforcing the maker/checker split at the subagent level.

**Removed dead weight:** The `prompts/` and `rules/` directories were synced from canonical sources but never consumed by any extension code. They have been replaced by the `agents/` and `skills/` directories.

### Details

- Refactored `sync.config.ts` to generate `agents/*.md` with pi-subagents YAML frontmatter
- Unified `sync.config.ts` to generate both agents and skills in a single pass (no separate sync-skills config)
- Added `packages/pi/src/agents.ts` - deploys agent files to `~/.pi/agent/agents/` on session start
- Simplified `rules.ts` - removed static file loading, renamed `createModePromptHandler` for mode-only injection
- Removed `pi.prompts` manifest field (misleading - registered template dirs, not for auto-injection)

## v0.3.0

_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.1.0

_June 22, 2026_

### Features

Initial release of `@maestria/pi` - a portable Pi extension that brings Maestria's spec-driven orchestration, workflow modes, and specialist subagents to the Pi coding agent.

- **8 specialist prompt templates** - one orchestrator plus seven specialist subagents (adventurer, architect, builder, diagnose, planner, reviewer, writer) with structured role definitions, permission boundaries, and delegation triggers
- **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 via the `before_agent_start` event
- **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`** - 6-field handoff validation ensures every delegation carries the right context, constraints, and completion criteria
- **`/orchestrate`, `/review`, `/maestria-status` commands** - slash commands for dispatching work, requesting reviews, and inspecting extension state
- **Maker/checker enforcement** - tool-call interception prevents the orchestrator from implementing its own tasks, enforcing the separation of dispatch from execution
- **2 methodology skills** - handoff contract (standardized delegation format) and iteration limits (max 3 proofread-revise cycles before escalation)