Use this skill when starting a new milestone cycle, beginning the next version, creating a new milestone, or planning what's next after completing a milestone. Triggers include "new milestone", "start milestone", "next milestone", "create milestone", and "milestone cycle".
View on GitHubgannonh/kata-marketplace
kata
plugins/kata/skills/kata-starting-milestones/SKILL.md
January 24, 2026
Select agents to install to:
npx add-skill https://github.com/gannonh/kata-marketplace/blob/main/plugins/kata/skills/kata-starting-milestones/SKILL.md -a claude-code --skill kata-starting-milestonesInstallation paths:
.claude/skills/kata-starting-milestones/<objective> Start a new milestone through unified flow: questioning → research (optional) → requirements → roadmap. This is the brownfield equivalent of project-new. The project exists, PROJECT.md has history. This command gathers "what's next", updates PROJECT.md, then continues through the full requirements → roadmap cycle. **Creates/Updates:** - `.planning/PROJECT.md` — updated with new milestone goals - `.planning/research/` — domain research (optional, focuses on NEW features) - `.planning/REQUIREMENTS.md` — scoped requirements for this milestone - `.planning/ROADMAP.md` — phase structure (continues numbering) - `.planning/STATE.md` — reset for new milestone **After this command:** Run `/kata:phase-plan [N]` to start execution. </objective> <execution_context> @./references/questioning.md @./references/ui-brand.md @./references/project-template.md @./references/requirements-template.md </execution_context> <context> Milestone name: $ARGUMENTS (optional - will prompt if not provided) **Load project context:** @.planning/PROJECT.md @.planning/STATE.md @.planning/MILESTONES.md @.planning/config.json **Load milestone context (if exists, from /kata:discuss-milestone):** @.planning/MILESTONE-CONTEXT.md </context> <process> ## Phase 1: Load Context - Read PROJECT.md (existing project, Validated requirements, decisions) - Read MILESTONES.md (what shipped previously) - Read STATE.md (pending todos, blockers) - Check for MILESTONE-CONTEXT.md (from /kata:discuss-milestone) ## Phase 2: Gather Milestone Goals **If MILESTONE-CONTEXT.md exists:** - Use features and scope from discuss-milestone - Present summary for confirmation **If no context file:** - Present what shipped in last milestone - Ask: "What do you want to build next?" - Use AskUserQuestion to explore features - Probe for priorities, constraints, scope ## Phase 3: Determine Milestone Version - Parse last version from MILESTONES.md - Suggest next version (v1.0 → v1.1, or v2.0 for major) - Confirm wi