gsd-new-milestone

Launch a milestone planning workflow updating PROJECT.md, REQUIREMENTS.md, ROADMAP.md, STATE.md and optionally research files for Git-based SD.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/ev3rlit/magam-canonical-archive --skill gsd-new-milestone-ev3rlit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-new-milestone
Source: https://github.com/ev3rlit/magam-canonical-archive/tree/main/.codex/skills/gsd-new-milestone
Command: npx skills add https://github.com/ev3rlit/magam-canonical-archive --skill gsd-new-milestone-ev3rlit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Start a new milestone cycle by updating planning documents and routing to requirements.

Core Features & Use Cases

  • Automatically update .planning/PROJECT.md with milestone goals.
  • Create or update planning artifacts for research, requirements, and roadmap.
  • Route to the next milestone and refresh state for execution.

Quick Start

Initiate the planning workflow to initialize a new milestone and refresh project state.

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 milestone planning for an ongoing project?

To start milestone planning, initiate the workflow to initialize a new milestone. This automatically updates your project goals in PROJECT.md, refreshes the roadmap, and resets STATE.md to route directly into requirements gathering.

What planning documents need to be updated when launching a new project milestone?

Launching a new project milestone updates PROJECT.md with milestone goals, creates or updates REQUIREMENTS.md and ROADMAP.md, and resets STATE.md. It optionally collects domain research in the .planning/research/ directory to align documentation.

How does a milestone planning workflow align project roadmap and requirements?

A milestone planning workflow aligns the roadmap and requirements by automatically creating or updating REQUIREMENTS.md and ROADMAP.md, ensuring ongoing project documentation reflects the new milestone goals before execution begins.

Can I collect domain research as part of project milestone initialization?

Yes, you can collect domain research during project milestone initialization. The workflow optionally gathers research data in the .planning/research/ directory as part of the planning cadence to support structured requirements.

What happens to project state when resetting for a new milestone cycle?

When resetting for a new milestone cycle, the project state in STATE.md is refreshed to route to requirements. This clears the previous execution state, preparing the updated planning documents for the next execution phase.

Do I need existing planning artifacts to initialize a new milestone?

No, existing planning artifacts are not strictly required. The workflow creates or updates REQUIREMENTS.md and ROADMAP.md if they are missing, and applies to ongoing projects that need structured milestone planning and roadmap alignment.