gsd-new-project

Initialize projects by generating planning artifacts and project state.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/dobrinz123/claude-skills-share --skill gsd-new-project-dobrinz123
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-new-project
Source: https://github.com/dobrinz123/claude-skills-share/tree/main/skills/gsd-new-project
Command: npx skills add https://github.com/dobrinz123/claude-skills-share --skill gsd-new-project-dobrinz123

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the friction of initial project setup by guiding questioning, optional domain research, and producing standardized planning artifacts so teams can move straight into execution.

Core Features & Use Cases

  • Guided Initialization: Interactive configuration and questioning to capture project context and preferences.
  • Automated Documentation: Generates .planning/PROJECT.md, .planning/config.json, optional research folders, REQUIREMENTS.md, ROADMAP.md, and STATE.md to create a consistent project baseline.
  • Workflow Preservation: Preserves validation, approval, commit, and routing gates so handoffs and verification remain intact.
  • Use Case: A product manager or engineering lead uses this to convert an idea into a documented project plan and roadmap that the team can act on.

Quick Start

Run gsd-new-project with an idea reference or --auto to generate the planning directory, requirements, roadmap, and project state.

Frequently Asked Questions about gsd-new-project

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

FAQPage Schema
How do I create structured project planning artifacts like a roadmap and requirements before development?

To create structured project planning artifacts before development, you can use guided initialization to interactively capture context and automatically generate a PROJECT.md, REQUIREMENTS.md, ROADMAP.md, and STATE.md. This ensures a consistent project baseline for execution.

What is the best way to initialize a new project with a roadmap and requirements documentation?

The best way to initialize a new project with a roadmap is to run an automated project setup that gathers context and generates a standardized .planning directory. This produces consistent requirements and roadmap files while preserving validation and approval gates.

Can I automatically generate a project state file and config without manual setup?

Yes, you can automatically generate a project state file and config by running project initialization with an idea reference or an auto flag. This creates .planning/config.json and .planning/STATE.md alongside your requirements and roadmap documentation.

Does guided project initialization preserve workflow validation and approval gates?

Guided project initialization does preserve workflow validation, approval, commit, and routing gates. This ensures that team handoffs and verification processes remain intact within the generated project baseline and state tracking files.

What files do I need to kickstart a project with structured planning?

To kickstart a project with structured planning, you need files including .planning/PROJECT.md, config.json, REQUIREMENTS.md, ROADMAP.md, and STATE.md. Optional research folders can also be generated to capture domain context during initialization.

Why should product managers use automated documentation for project setup?

Product managers should use automated documentation for project setup to eliminate friction and convert ideas into documented plans. It produces standardized planning artifacts, allowing teams to move straight into execution with a consistent roadmap and requirements baseline.