Changelog

v0.3.13

September 30, 2026

• Agents reassess explanatory comments and redundant tests before accepting changes, and shared directive text was consolidated with no behavior change; see the methodology changelog.

v0.3.12

September 25, 2026

• Agents follow behavior-first testing guidance and deliver work as verified, reviewable slices with designs shown before implementation; see the methodology changelog.

v0.3.11

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.

v0.3.10

September 18, 2026

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

v0.3.9

September 17, 2026

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

v0.3.8

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.3.7

September 15, 2026

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

v0.3.6

September 11, 2026

• Internal consolidation; duplicated specialist guidance was removed from generated orchestrator skills, with the guidance unchanged in substance.

v0.3.5

September 6, 2026

• Clarified installation paths, prerequisites, and support boundaries in the package documentation.
• Cross-cutting agent methodology update; see the methodology changelog.

v0.3.4

September 4, 2026

• Cross-cutting agent methodology update; see the methodology changelog.

v0.3.3

September 3, 2026

• Cross-cutting agent methodology update; see the methodology changelog.

v0.3.2

August 25, 2026

• Cross-cutting agent methodology update; see the methodology changelog.

v0.3.1

August 24, 2026

• Cross-cutting agent methodology update; see the methodology changelog.

v0.3.0

August 22, 2026

Leaner directives, explicit delivery autonomy

• Cross-cutting agent methodology update; see the methodology changelog.

v0.2.1

Marketplace and CLI installation

• The published package can be installed, checked, updated, and removed with maestria install claude-code, maestria status, maestria update claude-code, and maestria uninstall claude-code.
• The maestria CLI stages the npm package in a local marketplace and delegates installation state to Claude Code’s native plugin manager.
• Exact version pinning is not supported for maestria update claude-code --version; the host marketplace selects the latest package.
• Plugin metadata now stays aligned with package versions: release-time version sync is generalized across plugins and a --check mode fails the build on drift, so the published plugin artifact can no longer diverge from npm metadata.
• Cross-cutting agent methodology update; see the methodology changelog.

v0.2.0

Initial release

Declarative Claude Code plugin

@maestria/claude-code is a declarative Claude Code plugin generated from the canonical directives in packages/core/agent-directives/:

• 7 specialist agents with global-rules skill preloading - adventurer, architect, builder, diagnose, planner, reviewer, writer - available as @maestria:<agent> mentions
• Orchestrator and global-rules skills - /maestria:orchestrator routes work to specialists; maestria:global-rules is preloaded into every agent
• Workflow commands - /maestria:fein, /maestria:sonar, and /maestria:blitz select the pipeline depth
• Read-only enforcement - adventurer, planner, and reviewer deny Write/Edit via disallowedTools (user-authorized; the only runtime enforcement)
• Local validation - claude plugin validate --strict is the automated gate; marketplace installation is available through Claude Code or the maestria CLI

Shared directive updates

The plugin tracks the shared agent directives as they evolve. Cross-cutting changes reflected in this release are tracked in the methodology changelog.