gsd:new-project

Initialize a software project with requirements, roadmap, and Git setup.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/tDalile/dotfiles --skill gsd-new-project-tdalile
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd:new-project
Source: https://github.com/tDalile/dotfiles/tree/main/agents/skills/gsd/commands/new-project
Command: npx skills add https://github.com/tDalile/dotfiles --skill gsd-new-project-tdalile

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps users start a new software project from scratch by systematically gathering vision, defining requirements, and creating a detailed roadmap, eliminating guesswork and disorganized planning.

Core Features & Use Cases

  • Setup: Initializes a Git repository and creates a .planning/ directory for project artifacts.
  • Brownfield detection: Offers to map existing codebases before proceeding.
  • Deep questioning: Conducts an interactive conversation to extract the project's vision and goals.
  • Optional research: Can spawn parallel researchers to explore domain stacks, features, architecture, and pitfalls.
  • Requirements definition: Generates REQUIREMENTS.md with scoped v1 features and future considerations.
  • Roadmap creation: Produces a phased roadmap with success criteria.
  • State initialization: Creates STATE.md to store ongoing project memory.

Quick Start

Run the new‑project command to interactively define your project's vision, requirements, and roadmap.

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 software project with a structured roadmap and requirements?▼

To initialize a new software project, this Skill guides you through an interactive questioning phase to define your vision, then generates a structured roadmap, REQUIREMENTS.md, and STATE.md files within a .planning directory alongside Git setup.

Can I map an existing codebase before generating project requirements and a roadmap?▼

Yes, you can map an existing codebase before generating requirements. The Skill features brownfield detection, offering to analyze your current code structure before proceeding with the interactive planning and roadmap creation phases.

What is the best way to document project vision and scope for a new codebase?▼

The best way to document project vision is through deep questioning. This Skill conducts an interactive conversation to extract your goals, producing a REQUIREMENTS.md with scoped v1 features and future considerations for your new codebase.

Does this project initialization tool handle Git setup and state management?▼

Yes, this project initialization tool handles Git setup by initializing a repository. It also creates a STATE.md file to store ongoing project memory, ensuring your development state is tracked from the beginning.

Can I research domain architecture and pitfalls during project initialization?▼

Yes, you can research domain architecture and pitfalls during project initialization. The Skill can spawn parallel researchers to explore domain stacks, features, architecture, and potential pitfalls before finalizing your roadmap.