gsd-new-milestone

Initialize a milestone cycle by updating .planning artifacts and routing to requirements.

8|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/D0NMEGA/donnyclaude --skill gsd-new-milestone-d0nmega
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-new-milestone
Source: https://github.com/D0NMEGA/donnyclaude/tree/main/packages/skills/gsd-new-milestone
Command: npx skills add https://github.com/D0NMEGA/donnyclaude --skill gsd-new-milestone-d0nmega

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Start a new milestone cycle by updating planning artifacts and routing to requirements.

Core Features & Use Cases

  • Update PROJECT.md with new milestone goals.
  • Create/Update: .planning/PROJECT.md; .planning/research/ (optional, NEW features only); .planning/REQUIREMENTS.md; .planning/ROADMAP.md; .planning/STATE.md.
  • After: /gsd-plan-phase [N] to start execution.

Quick Start

Run the gsd-new-milestone workflow to initialize the planning cycle.

Frequently Asked Questions about gsd-new-milestone

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

FAQPage Schema
How do I start a new milestone cycle for an existing project?

To start a new milestone cycle, run the workflow to update planning artifacts like PROJECT.md and route directly to requirements initialization. This process updates your roadmap and state files to align planning for upcoming milestones.

What planning files are generated when initializing project milestones?

Initializing project milestones creates or updates .planning/PROJECT.md, .planning/research/, .planning/REQUIREMENTS.md, .planning/ROADMAP.md, and .planning/STATE.md. These files capture goals, requirements, and current cycle status.

Do I need an existing PROJECT.md to use this milestone planning workflow?

Yes, this milestone planning workflow requires an existing project with a history of PROJECT.md. It is designed to guide questioning and roadmap activities for upcoming milestones based on that prior project context.

When should I use the optional research directory in requirements planning?

Use the optional research directory in requirements planning specifically for NEW features only. It is created or updated during the milestone cycle to help guide questioning and research activities before finalizing requirements.

What is the next step after updating project roadmap and requirements files?

After updating project roadmap and requirements files, the next step is to start execution by running /gsd-plan-phase [N]. This signals readiness to move from planning artifacts into active project execution.