gsd-new-milestone

Plan and initialize a new milestone cycle by updating planning files and routing to requirements.

Updated Mar 27, 2026
One-click install
npx skills add https://github.com/onelee85/my-skills --skill gsd-new-milestone-onelee85
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-new-milestone
Source: https://github.com/onelee85/my-skills/tree/main/gsd-new-milestone
Command: npx skills add https://github.com/onelee85/my-skills --skill gsd-new-milestone-onelee85

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Start a new milestone cycle — update PROJECT.md and route to requirements.

Core Features & Use Cases

  • Updates .planning/PROJECT.md with new milestone goals
  • Creates/updates .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

Invoke the gsd-new-milestone workflow to start a new milestone 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 initialize a new milestone cycle for an existing project?

To initialize a new milestone cycle, the workflow updates .planning/PROJECT.md and creates REQUIREMENTS.md, ROADMAP.md, and STATE.md, then routes to the requirements phase for execution.

What planning files are generated or updated when starting milestone planning?

Starting milestone planning updates .planning/PROJECT.md and creates or updates .planning/research/, REQUIREMENTS.md, ROADMAP.md, and STATE.md to record milestone state and goals.

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

Yes, this milestone planning workflow is applied to existing projects with an established .planning/PROJECT.md history to ensure a repeatable and auditable planning cycle.

How do I update project roadmap and requirements for a new milestone?

Updating the project roadmap and requirements involves running the workflow to enforce validation gates, modifying .planning/ROADMAP.md and REQUIREMENTS.md, and triggering the gsd-plan-phase workflow.

When should I create the .planning/research/ directory during project planning?

The .planning/research/ directory is created or updated during project planning optionally, specifically for NEW features only within the new milestone cycle.

What is the best way to route a project to the requirements phase after milestone setup?

The best way to route to the requirements phase after milestone setup is letting the workflow trigger gsd-plan-phase, ensuring validation gates are enforced and milestone state is recorded.