gsd-new-milestone

Update planning files and generate requirements and roadmap for a new milestone.

1|Updated May 24, 2026
One-click install
npx skills add https://github.com/tinner-deinno/innova-skills-lib --skill gsd-new-milestone-tinner-deinno
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-new-milestone
Source: https://github.com/tinner-deinno/innova-skills-lib/tree/main/core/gsd/gsd-new-milestone
Command: npx skills add https://github.com/tinner-deinno/innova-skills-lib --skill gsd-new-milestone-tinner-deinno

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps you start a new milestone cycle without losing historical context, by turning “what’s next” into scoped requirements, a structured roadmap, and a reset planning state.

Core Features & Use Cases

  • Milestone kickoff workflow: Routes through questioning → optional research → requirements → roadmap while preserving workflow gates and approval steps.
  • Brownfield support: Assumes the project already exists and that PROJECT.md contains history, then updates .planning/PROJECT.md accordingly.
  • Milestone artifacts creation/update: Updates .planning/PROJECT.md, optionally adds .planning/research/, and regenerates .planning/REQUIREMENTS.md, .planning/ROADMAP.md (continuing numbering), and .planning/STATE.md (reset for the new milestone).

Quick Start

Run the gsd-new-milestone skill and provide the milestone name when prompted, for example: “v1.1 Notifications.”

Frequently Asked Questions about gsd-new-milestone

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I plan a new milestone for an existing project without losing historical context?

To plan a new milestone for an existing project without losing history, use a brownfield workflow that preserves your PROJECT.md history. This process updates project context and generates scoped requirements and a phased roadmap for the next cycle.

What is the best way to reset the planning state for a new project milestone?

The best way to reset the planning state for a new milestone is to regenerate STATE.md after updating project requirements. This clears the previous phase's execution state, ensuring a clean slate before routing to phase planning.

How do I generate a phased roadmap and requirements from existing project history?

You can generate a phased roadmap and scoped requirements by running a requirements-to-roadmap planning pass on your existing project. This regenerates REQUIREMENTS.md and ROADMAP.md while continuing the numbering from your previous milestones.

Can I add new feature research when starting a milestone cycle?

Yes, you can add new feature research when starting a milestone cycle. The milestone kickoff workflow optionally creates a dedicated research directory to gather information before finalizing your scoped requirements and roadmap.

Does milestone planning work for brownfield projects with prior execution history?

Yes, milestone planning is specifically designed for brownfield projects where PROJECT.md already contains history. It updates the existing project context and applies a requirements-to-roadmap planning pass tailored for the next phase of development.