Skip to main content
Generaldavepoon

gsd:new-milestone

Start a new milestone cycle — update PROJECT.md and route to requirements

Stars
2,987
Source
davepoon/buildwithclaude
Updated
2026-05-26
Slug
davepoon--buildwithclaude--new-milestone
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/davepoon/buildwithclaude/HEAD/plugins/gsd/skills/new-milestone/SKILL.md -o .claude/skills/new-milestone.md

Drops the SKILL.md into .claude/skills/new-milestone.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

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 — phase structure (continues numbering)
  • .planning/STATE.md — reset for new milestone

After: /gsd:plan-phase [N] to start execution.

@${CLAUDE_PLUGIN_ROOT}/workflows/new-milestone.md @${CLAUDE_PLUGIN_ROOT}/references/questioning.md @${CLAUDE_PLUGIN_ROOT}/references/ui-brand.md @${CLAUDE_PLUGIN_ROOT}/templates/project.md @${CLAUDE_PLUGIN_ROOT}/templates/requirements.md Milestone name: $ARGUMENTS (optional - will prompt if not provided)

Project and milestone context files are resolved inside the workflow (init new-milestone) and delegated via <files_to_read> blocks where subagents are used.

Execute the new-milestone workflow from @${CLAUDE_PLUGIN_ROOT}/workflows/new-milestone.md end-to-end. Preserve all workflow gates (validation, questioning, research, requirements, roadmap approval, commits).