gsd-new-milestone

Starts a new milestone cycle by updating PROJECT.md and generating requirements and roadmap files.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When an existing project needs to move into its next phase of work, teams often lack a structured way to capture new goals, scope requirements, and plan phases. This Skill guides the transition from a completed milestone to a new one through a defined questioning, research, requirements, and roadmap workflow. ## Core Features & Use Cases - Milestone Kickoff Workflow: Runs a structured cycle of questioning, optional domain research, requirements gathering, and roadmap creation for brownfield projects. - Planning File Management: Creates and updates .planning/ artifacts including PROJECT.md, REQUIREMENTS.md, ROADMAP.md, and STATE.md with continued phase numbering. - Use Case: A team finishes version 1 of their order management app and wants to add reporting features. Run this Skill to capture the new milestone goals, scope the requirements, and produce a phased roadmap before execution begins. ## Quick Start Start a new milestone for this project called reporting dashboard and walk me through the requirements and roadmap.

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 an optional milestone name as the argument. It runs a workflow that gathers goals through questioning, optionally researches new domains, then produces REQUIREMENTS.md and ROADMAP.md before execution begins.

What files does the new milestone workflow create or update?

It updates .planning/PROJECT.md with new milestone goals, creates .planning/REQUIREMENTS.md and .planning/ROADMAP.md with continued phase numbering, resets .planning/STATE.md, and optionally writes domain research into .planning/research/.

When is domain research performed during milestone planning?

Research is optional and only runs for entirely new feature domains. If the milestone extends existing functionality, the workflow skips the research step and proceeds directly to requirements gathering.

What happens after the new milestone workflow completes?

After the roadmap is approved and committed, you run /gsd-plan-phase with a phase number to begin execution of the first planned phase. The milestone state is reset and ready for phase-level planning.

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

No, this skill is the brownfield equivalent designed for projects that already have a PROJECT.md with history. For greenfield projects, use the new-project workflow instead.