gsd-new-project

Initializes new projects through questioning, research, requirements, and roadmap generation.

1|Updated Aug 27, 2025
One-click install
npx skills add https://github.com/IgorGanapolsky/Random-Timer --skill gsd-new-project-igorganapolsky
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd-new-project
Source: https://github.com/IgorGanapolsky/Random-Timer/tree/main/.cursor/skills/gsd-new-project
Command: npx skills add https://github.com/IgorGanapolsky/Random-Timer --skill gsd-new-project-igorganapolsky

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting a new software project without structured context leads to vague requirements and misaligned execution. This Skill guides you through a unified initialization flow that captures project context, gathers requirements, and produces a phased roadmap before any code is written. ## Core Features & Use Cases - Deep Context Gathering: Runs a structured questioning workflow to capture project goals and constraints into .planning/PROJECT.md. - Optional Domain Research: Generates research notes in .planning/research/ to inform scoping decisions. - Requirements & Roadmap Generation: Produces .planning/REQUIREMENTS.md, .planning/ROADMAP.md, and .planning/STATE.md for phase-based execution. - Automatic Mode: Use the --auto flag with an idea document to run research, requirements, and roadmap generation without further interaction. - Use Case: You have a rough idea for a mobile app. Invoke the skill, answer the scoping questions, and receive a complete planning directory ready for phase-by-phase execution with /gsd-plan-phase 1. ## Quick Start Ask the assistant to run gsd-new-project and describe your project idea, optionally attaching an idea document with 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?▼

Invoke the gsd-new-project skill and answer the scoping questions it presents. It creates a .planning directory containing PROJECT.md, config.json, REQUIREMENTS.md, ROADMAP.md, and STATE.md, giving you a complete planning foundation before writing code.

How to run project initialization without answering questions interactively?▼

Use the --auto flag and reference an idea document with the @ syntax. The skill then runs research, requirements, and roadmap generation automatically without further interaction after the initial configuration questions.

What files does the project initialization workflow create?▼

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

What should I do after the project initialization completes?▼

Run /gsd-plan-phase 1 to begin executing the first phase defined in the generated ROADMAP.md. The initialization skill only produces planning artifacts; execution is handled by the separate phase-planning workflow.

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

Research is optional and depends on the workflow configuration and your answers during questioning. In --auto mode with a well-formed idea document, research runs as part of the unattended pipeline; otherwise it can be omitted for well-understood domains.