gsd-new-milestone

Initialize planning artifacts and route milestones to requirements via gsd-plan-phase.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/novatech2210-cmd/ImidusApp --skill gsd-new-milestone-novatech2210-cmd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-new-milestone
Source: https://github.com/novatech2210-cmd/ImidusApp/tree/main/.codex/skills/gsd-new-milestone
Command: npx skills add https://github.com/novatech2210-cmd/ImidusApp --skill gsd-new-milestone-novatech2210-cmd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Initiates a fresh milestone cycle by updating the central planning artifact (PROJECT.md) and routing to the necessary requirements.

Core Features & Use Cases

  • Update .planning/PROJECT.md with new milestone goals and context
  • Create or refresh .planning/REQUIREMENTS.md and .planning/ROADMAP.md to frame the milestone scope
  • Reset .planning/STATE.md to prepare for a clean milestone, and optionally scaffold domain research notes under .planning/research/
  • After planning, trigger execution with the gsd-plan-phase workflow to advance to the next phase

Quick Start

Run the new milestone workflow to initialize planning and start the first plan 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 start a new milestone cycle for an existing project?

Starting a new milestone cycle involves running a workflow that initializes or resets planning artifacts like PROJECT.md, ROADMAP.md, and REQUIREMENTS.md to establish fresh goals and scope for existing project environments.

What planning files do I need to set up project milestone governance?

Project milestone governance requires setting up .planning artifacts including PROJECT.md for goals, REQUIREMENTS.md and ROADMAP.md for scope, and STATE.md to prepare and track execution status.

Can I reset the project state when planning a new milestone?

You can reset the project state when planning a new milestone by resetting the .planning/STATE.md file, which clears previous execution tracking to prepare a clean baseline for the upcoming milestone cycle.

How do I scaffold domain research notes for roadmap planning?

You scaffold domain research notes for roadmap planning by optionally creating a .planning/research/ directory during the milestone initialization workflow to store contextual project information.

When should I trigger the plan phase workflow after milestone setup?

You should trigger the gsd-plan-phase workflow immediately after updating PROJECT.md and setting up planning artifacts to advance from planning to active execution control for the new milestone.

Does this milestone setup workflow work for brownfield projects?

This milestone setup workflow applies to brownfield projects by creating or resetting existing .planning artifacts like PROJECT.md and REQUIREMENTS.md to frame the new milestone scope without losing project context.