skills.rest
MINT-IA
MINT-IAOFFICIAL
Explore all skills by this author →
GitHub

gsd-new-milestone

Creates phased roadmaps and updates planning files for GitHub-based projects.

Updated Jan 25, 2026
Search Tags:#planning#research#requirements#roadmap#project-planning#milestone
One-click install
npx skills add https://github.com/MINT-IA/MINT --skill gsd-new-milestone-mint-ia
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd-new-milestone
Source: https://github.com/MINT-IA/MINT/tree/main/.claude/skills/gsd-new-milestone
Command: npx skills add https://github.com/MINT-IA/MINT --skill gsd-new-milestone-mint-ia

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps teams convert "what's next" into an actionable milestone by updating project planning artifacts, scoping requirements, and creating a phased roadmap so work can be executed consistently across releases.

Core Features & Use Cases

  • Milestone initiation: Prompt-driven creation of a new milestone cycle for an existing project, preserving history in PROJECT.md.
  • Scoped requirements & roadmap: Produces or updates REQUIREMENTS.md and ROADMAP.md for the milestone and optionally collects research for new features.
  • State reset & handoff: Resets .planning/STATE.md for a clean start and hands off to the phase planning workflow for execution.

Quick Start

Run the gsd-new-milestone skill to create a milestone named v1.1 Notifications, update .planning/PROJECT.md, generate REQUIREMENTS.md and ROADMAP.md, and reset .planning/STATE.md.

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

To start a new milestone, run this skill to update .planning/PROJECT.md, generate REQUIREMENTS.md and ROADMAP.md, and reset .planning/STATE.md for a clean execution cycle. It converts upcoming work into an actionable, phased roadmap.

What planning files are updated when initiating project milestone planning?▼

Milestone initiation updates .planning/PROJECT.md to preserve history, generates .planning/REQUIREMENTS.md and .planning/ROADMAP.md, and resets .planning/STATE.md to prepare the project for the next development phase.

Can I perform domain research when creating a new project roadmap?▼

Yes, during milestone creation you can optionally perform domain research for new features. The skill creates .planning/research artifacts to support scoping requirements and structuring the phased roadmap.

Do I need an existing PROJECT.md file to scope next work and generate a roadmap?▼

Yes, this milestone planning skill applies to existing projects where the repository already contains PROJECT.md and the team needs to scope requirements and structure a phased roadmap for upcoming work.

What's the best way to convert project requirements into a phased roadmap?▼

Use this milestone planning skill to scope requirements and automatically generate a structured ROADMAP.md. It ensures work is executed consistently across releases by resetting state and preserving workflow validation gates.

Why does milestone planning reset the project state file?▼

Resetting .planning/STATE.md provides a clean start for the new milestone cycle, ensuring accurate tracking during execution. It preserves workflow validation gates while handing off to the phase planning workflow.

Related Skills

Explore More Product & Management Skills→
onelee85onelee85

gsd-new-milestone

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

Community
Advanced
dobrinz123dobrinz123

gsd-autonomous

Execute remaining milestone phases with discuss, plan, and execute cycles.

Community
Advanced
YoshikemoloYoshikemolo
5

devflow-planning

Analyze Jira velocity and capacity to forecast sprint outcomes.

Community
Advanced
retz8retz8

planning

Creates structured plans with goals, scope, milestones, owners, timelines, and dependencies for projects.

Community
Basic