Skip to content

v0.9.0 Release Notes

Release Date: 2026-06-28

Highlights

  • REAL/VEAL autonomous loop patterns for automated fix cycles
  • Loop specifications for QA, docs, and security validation
  • Agents enriched with loop participation instructions

What's New

REAL/VEAL Loop Specifications

This release introduces formal loop specifications based on the REAL/VEAL patterns from multi-agent-spec:

Loop Type Validator Actor max_attempts
qa-fix VEAL qa code-fixer 3
docs-fix VEAL docs-reviewer docs-writer 3
security-fix VEAL security code-fixer 3
docs-next-version REAL - docs-writer 5

VEAL (Validate Eval Act Loop) - State-driven loops that converge toward valid state through validation checks. Used for QA, docs, and security fix loops.

REAL (Read Eval Act Loop) - Mission-driven loops for open-ended tasks. Used for release notes creation.

Loop-Aware Agents

All validation and fix agents now include loop participation instructions:

## Loop Participation

This agent participates in the **qa-fix** loop (VEAL pattern).

### Validator Role

As the **validator** in this loop, your responsibility is to:
1. Run all validation checks
2. Report GO/NO-GO status for each check
3. Provide detailed findings for any failures
4. Do NOT modify any files (read-only)

**Max Attempts:** 3
**Escalation Policy:** human

Bounded Execution

Loops are bounded to prevent infinite execution:

  • max_attempts: Maximum iterations (default: 3)
  • escalation: Policy when max reached (human, abort, continue, fallback)
  • success_criteria: Description of what success looks like

Release Coordinator Orchestration

The release-coordinator agent now orchestrates VEAL loops:

  1. Run validator agent (qa, docs-reviewer, or security)
  2. If GO → proceed to next loop
  3. If NO-GO → run actor agent (code-fixer or docs-writer)
  4. Re-run validator to verify fixes
  5. Repeat until GO or max_attempts reached
  6. On max_attempts → apply escalation policy

Full Changelog

Added

  • REAL/VEAL loop specifications in specs/loops/
  • qa-fix.yaml - VEAL loop for QA validation
  • docs-fix.yaml - VEAL loop for documentation validation
  • security-fix.yaml - VEAL loop for security scanning
  • docs-next-version.yaml - REAL loop for release notes creation
  • Loop participation instructions injected into validator/actor agents
  • Docs-reviewer agent with docs-fix loop participation
  • Docs-writer agent with docs-fix loop participation
  • Example docs-fix-loop reports showing loop execution

Changed

  • Release-coordinator orchestrates VEAL loops with max_attempts and escalation
  • All validation agents include loop participation sections

Dependencies

  • assistantkit v0.13.0 → v0.14.0 (loops package)
  • multi-agent-spec v0.8.0 → v0.9.0 (loop schema)

Documentation

  • Updated README with fix loop workflow diagram
  • Added docs-fix-loop.md orchestration documentation
  • Updated orchestration.md with loop details

Infrastructure

  • Regenerated Claude Code and Kiro CLI plugins
  • Regenerated plugins with loop instructions

Migration Guide

No breaking changes. Existing workflows continue to work.

The new loop specifications provide formal definitions for the fix loops that were previously implicit in the release-coordinator agent. If you have custom orchestration, you can now reference the loop specs in specs/loops/.