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.