Skip to content

Changelog

June 24, 2026

Project workflow configuration (.maestria/)

Section titled “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

Section titled “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.
  • Initial release of @maestria/kimi-code - a declarative, manifest-based plugin that ports the 8 specialist skills from @maestria/opencode v0.3.2 to Kimi Code v0.13.1.
  • 8 SKILL.md files - orchestrator + 7 specialists using the v0.3.x Skill Prescription pattern
  • Manifest-only plugin - no SDK hooks, no build step; the plugin is pure static config (kimi.plugin.json + skills/ + rules/)
  • Swarm-aware orchestration - the orchestrator routes ≥3 uniform items through Kimi Code’s AgentSwarm for parallel fan-out, with the 7-specialist table covering the coder / explore / plan subagent profiles
  • Global rules - rules/AGENTS.md with the 7-specialist delegation table, auto-loaded by Kimi Code from ~/.kimi-code/AGENTS.md
  • Install checklist - INSTALL.md with recommended [[hooks]] and [[permission.rules]] config blocks for tool-layer safety enforcement (persona text alone is advisory)
  • 20 vitest tests - validate manifest schema, frontmatter, rules budget, and persona safety constraints (reviewer no-edit, adventurer read-only Bash)

See ADR-KC-001 for the full design rationale.