Skip to content

Changelog

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.

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.

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.

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 11, 2026

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

September 6, 2026

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

September 4, 2026

September 3, 2026

August 27, 2026

  • The maestria CLI now installs seven native maestria-* Codex custom-agent roles.
  • The CLI adds a marked global instruction block so Codex’s host-owned primary session activates maestria orchestration and delegates with native agent_type role names.
  • Updates preserve user model, reasoning, and service-tier settings, and uninstall removes only maestria-managed agent files and instruction content.

August 25, 2026

August 24, 2026

August 22, 2026

Leaner directives, explicit delivery autonomy

Section titled “Leaner directives, explicit delivery autonomy”

August 13, 2026

  • Added maestria CLI compatibility: the CLI detects the Codex CLI host, stages the published npm package in a local marketplace, and delegates install, update, status, check, and uninstall operations to Codex’s native plugin manager.
  • Added the generated skills projection for the 7 specialists, orchestrator, global rules, handoff, iteration limits, and fein/sonar/blitz workflow modes.
  • Added maestria CLI compatibility: install, status, check, update, and uninstall now recognize the codex platform.
  • The CLI stages the npm package in a local Codex marketplace and delegates plugin state to Codex.
  • Codex desktop parity, hooks, MCP, model configuration, and hard read-only enforcement remain out of scope.

Initial Codex CLI projection. It packages the canonical maestria specialist, orchestration, rules, handoff, iteration-limit, and workflow-mode directives as Codex skills through .codex-plugin/plugin.json.