df:new-milestone

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

Updated Feb 6, 2026
One-click install
npx skills add https://github.com/AO-Cyber-Systems/devflow-claude --skill df-new-milestone
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: df:new-milestone
Source: https://github.com/AO-Cyber-Systems/devflow-claude/tree/main/skills/df-new-milestone
Command: npx skills add https://github.com/AO-Cyber-Systems/devflow-claude --skill df-new-milestone

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Start a new milestone cycle for an existing project by resetting planning state and updating key documents to align team efforts.

Core Features & Use Cases

  • Updates: .planning/PROJECT.md with milestone goals, .planning/STATE.md reset, and prepares .planning/ROADMAP.md and .planning/REQUIREMENTS.md for the new milestone.
  • Provides a guided workflow for transitioning from questioning to research to requirements to roadmap, with gates and commits, using the /df:plan-objective command to advance.

Quick Start

Provide an optional milestone name to initiate a new milestone planning cycle.

Frequently Asked Questions about df:new-milestone

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

FAQPage Schema
How do I automate milestone planning for an existing project roadmap?

Automate project milestone planning by initializing a new cycle that resets planning state and updates PROJECT.md, ROADMAP.md, and REQUIREMENTS.md to align team efforts. This workflow applies to existing projects with active roadmaps requiring formal milestone scoping and staged documentation updates.

What is the best way to start a new milestone cycle and reset project planning state?

Start a new milestone cycle by providing an optional milestone name to seed the process, which automatically resets the .planning/STATE.md file and prepares ROADMAP.md and REQUIREMENTS.md. This establishes a clean baseline for transitioning through questioning, research, requirements, and roadmap stages.

How does the milestone planning workflow transition between requirements and roadmap stages?

The milestone planning workflow transitions sequentially from questioning to research to requirements to roadmap stages using the /df:plan-objective command to advance. Each stage includes specific gates and commits to ensure structured progression throughout the project planning cycle.

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

This milestone planning workflow is designed for existing projects with active roadmaps requiring formal milestone scoping. It automates updates to existing .planning/ documents and resets current planning state, making it unsuitable for initializing entirely new projects without established roadmap files.

Do I need to manually update PROJECT.md and STATE.md when starting a new milestone?

You do not need to manually update PROJECT.md or STATE.md when starting a new milestone. The automation initializes the planning cycle by automatically updating PROJECT.md with milestone goals and resetting STATE.md to prepare for the new cycle.