# Df:new Milestone
> Start a new milestone cycle — update PROJECT.md and route to requirements. Lifecycle transition that resets requirements and roadmap — needs explicit intent.
- Skill: `majiayu000/df-new-milestone` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/df-new-milestone`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/df-new-milestone/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/df-new-milestone
---
Start a new milestone: questioning → research (optional) → requirements → roadmap.
Brownfield equivalent of new-project. Project exists, PROJECT.md has history. Gathers "what's next", updates PROJECT.md, then runs requirements → roadmap cycle.
**Creates/Updates:**
- `.planning/PROJECT.md` — updated with new milestone goals
- `.planning/research/` — domain research (optional, NEW features only)
- `.planning/REQUIREMENTS.md` — scoped requirements for this milestone
- `.planning/ROADMAP.md` — objective structure (continues numbering)
- `.planning/STATE.md` — reset for new milestone
**After:** `/df:plan-objective [N]` to start execution.
@~/.claude/devflow/workflows/new-milestone.md
@~/.claude/devflow/references/questioning.md
@~/.claude/devflow/references/ui-brand.md
@~/.claude/devflow/templates/project.md
@~/.claude/devflow/templates/requirements.md
Milestone name: $ARGUMENTS (optional - will prompt if not provided)
**Load project context:**
@.planning/PROJECT.md
@.planning/STATE.md
@.planning/MILESTONES.md
@.planning/config.json
**Load milestone context (if exists, from /df:discuss-milestone):**
@.planning/MILESTONE-CONTEXT.md
Execute the new-milestone workflow from @~/.claude/devflow/workflows/new-milestone.md end-to-end.
Preserve all workflow gates (validation, questioning, research, requirements, roadmap approval, commits).