Skip to content

v8.0.0 - Preference System and Epic Workflow State Tracking

Choose a tag to compare

@marcusgoll marcusgoll released this 20 Nov 19:39
· 141 commits to main since this release

⚠️ BREAKING CHANGES

Epic Template Format Migration: XML → Markdown

  • Epic workflow templates converted from XML to Markdown format (37% token reduction)
  • Existing epic workflows using .xml templates will need migration
  • All epic templates now use YAML frontmatter + Markdown structure
  • Benefits: Better readability, reduced context usage, improved maintainability

✨ Added

Preference System

  • New /init-preferences command for workflow customization
  • 3-tier preference system: config → learning → flags
  • Preferences stored in .spec-flow/config/preferences.yaml
  • Auto-detection of user patterns and learning over time
  • Supports auto-mode defaults, HITL gate preferences, and deployment model preferences

Epic Workflow State Tracking

  • Add workflow-state.yaml tracking for epic sprints (fixes missing sprint completion tracking)
  • Add auto-mode manual gates with auto_skipped status (fixes pending gate issue in auto-mode)
  • Add sprint completion tracking in /implement-epic command
  • Add layer completion tracking at epic level
  • Track sprint metrics: tasks, tests, contracts, duration
  • Epic-level progress visibility: "Layer 2/3 complete"

Manual Gate Improvements

  • Manual gates now properly initialized with auto_skipped when auto_mode: true
  • Interactive mode updates gates to approved with approval metadata
  • Auto-mode skips PAUSE points entirely (gates pre-marked as auto_skipped)
  • Added timestamps: skipped_at for auto-skipped, approved_at for interactive

🔧 Changed

  • Epic templates migrated from .xml to .md format
  • Workflow-state.yaml now includes detailed sprint execution metadata
  • Manual gates properly reflect auto-mode vs interactive mode execution state