gsd-new-project

name	gsd-new-project
description	Initialize a new project with deep context gathering and PROJECT.md
argument-hint	[--auto]
allowed-tools	["Read","Bash","Grep","Write","Agent","AskUserQuestion"]

<runtime_note> Copilot (VS Code): Use vscode_askquestions wherever this workflow calls AskUserQuestion. They are equivalent — vscode_askquestions is the VS Code Copilot implementation of the same interactive question API. </runtime_note>

**Flags:** - `--auto` — Automatic mode. After config questions, runs research → requirements → roadmap without further interaction. Expects idea document via @ reference. Initialize a new project through unified flow: questioning → research (optional) → requirements → roadmap.

Creates:

• .planning/PROJECT.md — project context
• .planning/config.json — workflow preferences
• .planning/research/ — domain research (optional)
• .planning/REQUIREMENTS.md — scoped requirements
• .planning/ROADMAP.md — phase structure
• .planning/STATE.md — project memory

After this command: Run /gsd-plan-phase 1 to start execution.

<execution_context> @/.claude/gsd-core/workflows/new-project.md @/.claude/gsd-core/references/questioning.md @/.claude/gsd-core/references/ui-brand.md @/.claude/gsd-core/templates/project.md @~/.claude/gsd-core/templates/requirements.md </execution_context>

Execute end-to-end. Preserve all workflow gates (validation, approvals, commits, routing).