moai-library-toon

Quick Reference (30 seconds)

TOON v4.0 = YAML-based hierarchical format inspired by BMAD Method

TOON (Token-Optimized Object Notation) adopts BMAD's clean YAML patterns for agent and workflow definitions. This provides 40-60% token reduction while maintaining full expressiveness.

Key Insight: BMAD's *.agent.yaml and workflow.yaml ARE the optimal token-efficient format.

Core Benefits:

• 40-60% token reduction vs JSON
• Clean hierarchical YAML structure
• Runtime variable substitution ({project-root}, {config_source}:key)
• Human-readable and LLM-parseable
• Proven in BMAD Method v6 (650+ files, 25+ agents)

TOON Agent Definition Pattern (BMAD-Style)