skills/new-milestone/SKILL.md
Start a new milestone cycle — update PROJECT.md and route to requirements
npx skillsauth add jnuyens/gsd-plugin gsd:new-milestoneInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
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 milestoneAfter: /gsd:plan-phase [N] to start execution.
</objective>
<execution_context> @${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 </execution_context>
<context> 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.
</context>
tools
Initialize a new project using Documentation-Driven Development. Research, then write user-facing docs (SPEC.md) as the spec, then user validates docs, then phases derive from doc sections. Best for CLIs, libraries, SDKs, APIs, plugin systems, anything with a well-defined user-facing surface.
tools
Schedule a future resume of work - e.g. '/gsd:resume-at 09:00', '/gsd:resume-at +2h', or '/gsd:resume-at 04:00 --cmd /gsd:execute-phase 9'
tools
Manage parallel workstreams — list, create, switch, status, progress, complete, and resume
tools
Manage persistent context threads for cross-session work