Skip to main content

​
Overview

The gsd:new-project command initializes a new project through a unified flow: questioning → research (optional) → requirements → roadmap. This is the starting point for any new Get Shit Done project.

​
Usage

​
Parameters

​
flag
Automatic mode. After config questions, runs research → requirements → roadmap without further interaction. Expects idea document via @ reference.

​
How It Works

The command executes a unified workflow that:
  1. Questions - Gathers initial project context through adaptive questioning
  2. Research (optional) - Conducts domain research if needed
  3. Requirements - Documents scoped requirements based on your inputs
  4. Roadmap - Creates a phase structure for execution
All workflow gates (validation, approvals, commits, routing) are preserved during execution.

​
Files Created

This command creates a complete .planning/ directory structure:
​
file
Project context document - the source of truth for what you’re building
​
file
Workflow preferences and configuration settings
​
directory
Domain research directory (created when research is needed)
​
file
Scoped requirements document defining what needs to be built
​
file
Phase structure defining the execution plan
​
file
Project memory tracking progress and state

​
Examples

​
Interactive Mode

Runs the full initialization flow with interactive questioning at each stage.

​
Automatic Mode

Runs the entire flow automatically after initial config questions, using the referenced idea document as context.
In automatic mode, you must provide an idea document via @ reference for the system to work with.

​
Next Steps

After running gsd:new-project, start working on your first phase:
This will create a detailed execution plan for phase 1 of your roadmap.

​
Allowed Tools

This command has access to:
  • Read - Read existing files
  • Bash - Execute shell commands
  • Write - Create new files
  • Task - Delegate to specialized agents
  • AskUserQuestion - Interactive questioning