skills.rest
gesmith0606
gesmith0606COMMUNITY
Explore all skills by this author →
GitHub

gsd-new-milestone

Generate and update planning artifacts for a new milestone cycle.

Updated Aug 15, 2025
Search Tags:#workflow#requirements#roadmap#project-planning#milestone#project-docs
One-click install
npx skills add https://github.com/gesmith0606/nfl_data_engineering --skill gsd-new-milestone-gesmith0606
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd-new-milestone
Source: https://github.com/gesmith0606/nfl_data_engineering/tree/main/.claude/skills/gsd-new-milestone
Command: npx skills add https://github.com/gesmith0606/nfl_data_engineering --skill gsd-new-milestone-gesmith0606

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the initial milestone planning cycle for an existing project by updating project planning files, gathering optional research, and producing scoped requirements and a phase-based roadmap so teams can move from idea to execution without manual file churn.

Core Features & Use Cases

  • Project bootstrapping: Update .planning/PROJECT.md with the new milestone entry and preserve historical context.
  • Requirements & roadmap generation: Create or update .planning/REQUIREMENTS.md and .planning/ROADMAP.md with scoped features, phases, and numbering that continue the project's planning rhythm.
  • Research and state management: Optionally create .planning/research/ for domain research on new features and reset .planning/STATE.md for the new milestone.
  • Operational workflow: Run the full new-milestone workflow with validation gates, questioning, optional research, approvals, commits, and handoff to the plan-phase executor.

Quick Start

Start a new milestone named "v1.1 Notifications" and update PROJECT.md, create REQUIREMENTS.md and ROADMAP.md, optionally collect research, reset STATE.md, and prepare the repository for the planning phase.

Frequently Asked Questions about gsd-new-milestone

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scope a new project milestone and generate roadmap files automatically?▼

To scope a new project milestone, this Skill updates repository planning artifacts by generating or updating PROJECT.md, REQUIREMENTS.md, and ROADMAP.md with phased features and numbering that continue your existing planning rhythm.

What planning files do I need in my repository to kick off a new milestone cycle?▼

You need a .planning/ directory containing PROJECT.md to kick off a new milestone cycle. The Skill then produces or updates REQUIREMENTS.md, ROADMAP.md, and resets STATE.md for the new milestone.

How does milestone planning work with validation gates and optional research steps?▼

Milestone planning works by running a workflow with validation gates, questioning, optional domain research in a .planning/research/ folder, approvals, and commits to produce scoped requirements ready for execution.

Can I preserve historical project context when updating planning artifacts for a new milestone?▼

Yes, you can preserve historical context when updating planning artifacts. The Skill updates PROJECT.md with the new milestone entry while maintaining existing historical project data and workflow gates.

What is the best way to transition from milestone requirements generation to the execution phase?▼

The best way to transition to execution is through the Skill's handoff to the plan-phase executor, which occurs after scoped requirements and a phase-based roadmap are committed to the repository.

Does milestone planning support creating research folders for investigating new features?▼

Yes, milestone planning supports creating optional .planning/research/ folders for domain research on new features, allowing you to gather investigative context before finalizing scoped requirements and the roadmap.

Related Skills

Explore More Product & Management Skills→
giovannimnzgiovannimnz

gsd-new-project

Initialize a new project by generating a planning scaffold with PROJECT.md, ROADMAP.md, REQUIREMENTS.md, and STATE.md.

Community
Advanced
dobrinz123dobrinz123

gsd-autonomous

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

Community
Advanced
AO-Cyber-SystemsAO-Cyber-Systems

df:new-milestone

Initialize a new milestone planning cycle and reset planning state files.

Official
Intermediate
Pear-CommercePear-Commerce

gsd-add-phase

Add sequential integer phases to the active GSD milestone roadmap.

Official
Intermediate