gsd-new-milestone

Start a new project milestone by updating PROJECT.md and generating requirements and roadmap files.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a project already exists and you need to kick off the next development cycle, manually re-scoping goals, requirements, and phase plans is error-prone. This Skill automates the brownfield milestone kickoff: it gathers what's next, updates project history, and produces scoped requirements and a continuing roadmap. ## Core Features & Use Cases - Milestone Kickoff Workflow: Runs a structured questioning → optional research → requirements → roadmap cycle for an existing project. - Planning File Management: Creates and updates .planning/PROJECT.md, REQUIREMENTS.md, ROADMAP.md, and resets STATE.md for the new milestone. - Optional Domain Research: Generates research notes under .planning/research/ for entirely new feature areas. - Use Case: After shipping v1.0, you want to start "v1.1 Notifications". Invoke the Skill with the milestone name and it interviews you, updates PROJECT.md, scopes REQUIREMENTS.md, and extends ROADMAP.md with continuing phase numbering. ## Quick Start Ask the assistant to start a new milestone named v1.1 Notifications using the gsd-new-milestone skill.

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 for an existing project?▼

Invoke the gsd-new-milestone skill with a milestone name such as "v1.1 Notifications". It runs a questioning workflow, updates .planning/PROJECT.md, then generates scoped REQUIREMENTS.md and an extended ROADMAP.md for the new cycle.

What files does the new milestone workflow create or update?▼

It updates .planning/PROJECT.md with new milestone goals, creates .planning/REQUIREMENTS.md and extends .planning/ROADMAP.md with continuing phase numbers, resets .planning/STATE.md, and optionally writes research notes under .planning/research/.

When is domain research generated during milestone planning?▼

Research under .planning/research/ is optional and only produced for entirely new feature areas. If the milestone builds on existing, well-understood functionality, the research step is skipped.

What happens after the milestone roadmap is created?▼

After the roadmap is approved, you run /gsd-plan-phase [N] to begin executing the first phase. The milestone skill only handles scoping and planning, not phase implementation.

Can I use this skill for a brand-new project with no history?▼

No. This skill is the brownfield equivalent of new-project and assumes PROJECT.md already contains history. For greenfield projects, use the new-project workflow instead.