skills.rest
ArtRiv
ArtRivCOMMUNITY
Explore all skills by this author →
GitHub

gsd-new-milestone

Plan and initialize a new milestone cycle with scoped requirements and a roadmap.

Updated Feb 11, 2026
Search Tags:#research#workflow automation#requirements#roadmap#project documentation#brownfield#milestone planning
One-click install
npx skills add https://github.com/ArtRiv/game-topicos-especiais --skill gsd-new-milestone-artriv
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd-new-milestone
Source: https://github.com/ArtRiv/game-topicos-especiais/tree/main/.github/skills/gsd-new-milestone
Command: npx skills add https://github.com/ArtRiv/game-topicos-especiais --skill gsd-new-milestone-artriv

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It turns an existing project’s “what’s next” ambiguity into a structured milestone plan with scoped requirements, a roadmap, and a reset state so execution can begin cleanly.

Core Features & Use Cases

  • Milestone kickoff for brownfield projects: Uses existing project history where PROJECT.md already exists and continues milestone sequencing rather than starting from scratch.
  • Questioning → optional research → requirements → roadmap: Guides the team through what to do next, optionally performs domain research for NEW features, then produces milestone-specific requirements and a roadmap phase structure.
  • Stateful planning updates: Updates the planning artifacts in .planning (goals, requirements, roadmap, and milestone state) so downstream execution can start.

Quick Start

Start a new milestone by running the gsd-new-milestone skill and providing the milestone name when prompted.

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 the next milestone for an existing brownfield project?▼

To plan a new milestone, the workflow guides you through questioning, optional research for new features, requirements generation, and roadmap approval. It then updates all planning artifacts including PROJECT.md, REQUIREMENTS.md, ROADMAP.md, and STATE.md to trigger execution.

What is the workflow for turning project requirements into a roadmap?▼

This workflow coordinates questioning, optional research, requirements generation, and roadmap approval. It updates planning artifacts like REQUIREMENTS.md and ROADMAP.md to establish a scoped phase structure for execution.

Do I need existing project documentation to initialize a new milestone cycle?▼

You need an existing .planning directory with PROJECT.md, REQUIREMENTS.md, ROADMAP.md, and STATE.md. The workflow updates these artifacts with new milestone goals, requirements, and state resets to maintain continuous milestone numbering.

How does milestone planning handle new feature research?▼

The workflow includes an optional research step to gather domain knowledge for new features. This research feeds directly into requirements generation and roadmap planning, ensuring new feature scope is well-defined.

What planning files are updated when kicking off a new milestone?▼

The workflow updates .planning/PROJECT.md, .planning/REQUIREMENTS.md, .planning/ROADMAP.md, and .planning/STATE.md. These updates ensure goals, requirements, roadmap commitments, and execution state are synchronized before the plan-phase begins.

Can I use this milestone planning workflow for a brand new greenfield project?▼

This workflow is designed for brownfield projects with existing planning artifacts. For greenfield projects, a different initialization workflow would be needed to establish the initial PROJECT.md and planning structure.

Related Skills

Explore More Product & Management Skills→
deerawandeerawan
1

gsd-new-milestone

Plan and initialize a new milestone cycle from PROJECT.md history.

Community
Intermediate
oxieoxie

finalize-phase

Archive feature artifacts, update roadmap to Shipped, and clean up branches.

Community
Basic
jedmamostojedmamosto

gsd-complete-milestone

Archive completed milestone roadmap and requirements with a versioned git tag.

Community
Intermediate
GenerativeAgentsGenerativeAgents

prd-writing

Generate a review-ready PRD from initial-requirements.md using the PRD template.

Official
Advanced