Breaking Changes
-
Mission system refactored to per-feature model
- Missions are now selected during
/spec-kitty.specifyinstead ofspec-kitty init - Each feature stores its mission in
meta.json(field:"mission": "software-dev") .kittify/active-missionsymlink/file is no longer used- Run
spec-kitty upgradeto clean up existing projects
- Missions are now selected during
-
Removed commands
spec-kitty mission switch- Missions are now per-feature, not per-project- Running this command now shows a helpful error message explaining the new workflow
-
Removed flags
--missionflag fromspec-kitty init- Use/spec-kitty.specifyinstead- Flag is hidden but shows deprecation warning if used
Added
-
Mission inference during
/spec-kitty.specify- LLM analyzes feature description and suggests appropriate mission:- "Build a REST API" → suggests
software-dev - "Research best practices" → suggests
research - User confirms or overrides the suggestion
- Explicit
--missionflag bypasses inference
- "Build a REST API" → suggests
-
Per-feature mission storage - Selected mission stored in feature's
meta.json:- All downstream commands read mission from feature context
- Legacy features without mission field default to
software-dev
-
Mission discovery - New
discover_missions()function returns all available missions with source indicators -
Updated
spec-kitty mission list- Shows source column (project/built-in) for each mission -
Migration for v0.8.0 -
spec-kitty upgraderemoves obsolete.kittify/active-missionfile -
AGENTS.md worktree fix - New worktrees get AGENTS.md symlink, and
spec-kitty upgradefixes existing worktrees
Changed
- All downstream commands (
/spec-kitty.plan,/spec-kitty.tasks,/spec-kitty.implement,/spec-kitty.review,/spec-kitty.accept) now read mission from feature'smeta.json create-new-feature.shaccepts--mission <key>parameter to set mission in meta.json- Common bash/PowerShell scripts updated to resolve mission from feature directory
spec-kitty mission currentshows current default mission (for informational purposes)- Dashboard template now includes dynamic AGENTS.md path discovery instructions
Deprecated
set_active_mission()function - Shows deprecation warning, will be removed in future version
Migration Guide
- Run
spec-kitty upgradeto remove.kittify/active-mission - Existing features without
missionfield will usesoftware-devby default - New features will have mission set during
/spec-kitty.specify