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)