gsd-new-project

Initialize new projects by generating PROJECT.md, requirements, and roadmap planning documents.

Updated Feb 18, 2026
One-click install
npx skills add https://github.com/jjchambers80/judgesdirectory --skill gsd-new-project-jjchambers80
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd-new-project
Source: https://github.com/jjchambers80/judgesdirectory/tree/main/.github/skills/gsd-new-project
Command: npx skills add https://github.com/jjchambers80/judgesdirectory --skill gsd-new-project-jjchambers80

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting a new software project often lacks structure, leading to unclear requirements and missing context. This Skill guides you through a unified initialization flow that captures project context, requirements, and a phased roadmap before any code is written. ## Core Features & Use Cases - Structured Project Initialization: Runs a questioning → research → requirements → roadmap workflow that produces PROJECT.md, REQUIREMENTS.md, and ROADMAP.md in a .planning directory. - Automatic Mode: The --auto flag runs research, requirements, and roadmap generation without further interaction after initial config questions. - Persistent Project Memory: Creates config.json and STATE.md so subsequent planning commands retain workflow preferences and project state. - Use Case: You have a rough product idea documented in a markdown file. Run this Skill with the idea referenced to produce a complete planning foundation, then start execution with /gsd-plan-phase 1. ## Quick Start Initialize a new project by running the gsd-new-project skill with your idea document referenced, optionally adding the --auto flag for unattended setup.

Frequently Asked Questions about gsd-new-project

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I initialize a new project with structured planning documents?▼

Run the gsd-new-project skill and provide your project idea, optionally via an @ referenced document. It guides you through questioning, optional research, requirements definition, and roadmap creation, writing all outputs to a .planning directory.

What files does the new project initialization workflow create?▼

The workflow creates PROJECT.md for context, config.json for workflow preferences, REQUIREMENTS.md for scoped requirements, ROADMAP.md for phase structure, and STATE.md for project memory, all inside the .planning directory.

Can I run project initialization without answering questions interactively?▼

Yes, pass the --auto flag to enable automatic mode. After the initial config questions, it runs research, requirements, and roadmap generation without further interaction, expecting the idea document via an @ reference.

What should I do after initializing a new project?▼

After initialization completes, run /gsd-plan-phase 1 to begin executing the first phase defined in the generated ROADMAP.md. The STATE.md file preserves project memory across these commands.

When is the optional research step used during project setup?▼

The research step gathers domain context into .planning/research/ when the project area is unfamiliar or needs validation. It runs as part of the standard flow and is included automatically in --auto mode.