skills.rest
WeWake1
WeWake1COMMUNITY
Explore all skills by this author →
GitHub

gsd-new-project

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

Updated Mar 15, 2026
Search Tags:#workflow#planning#research#requirements#roadmap#context gathering#project initialization
One-click install
npx skills add https://github.com/WeWake1/BSOMS --skill gsd-new-project-wewake1
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd-new-project
Source: https://github.com/WeWake1/BSOMS/tree/main/.agent/skills/gsd-new-project
Command: npx skills add https://github.com/WeWake1/BSOMS --skill gsd-new-project-wewake1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting a new software project without structured context leads to vague requirements, missed scope, and chaotic execution. 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 - Deep Context Gathering: Runs a structured questioning workflow to capture project intent and stores it in .planning/PROJECT.md. - Optional Domain Research: Generates research notes in .planning/research/ to ground decisions in domain knowledge. - Requirements & Roadmap Generation: Produces scoped REQUIREMENTS.md and a phased ROADMAP.md, plus STATE.md for project memory. - Automatic Mode: The --auto flag runs research, requirements, and roadmap generation without further interaction, using an idea document passed via @ reference. - Use Case: You have a rough product idea for an order tracking app. Run this Skill to turn it into a full planning package with requirements and a phase roadmap, then start execution with /gsd-plan-phase 1. ## Quick Start Ask the AI to initialize a new project with the gsd-new-project skill, optionally passing your idea document and 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, which guides you through questioning, optional research, requirements scoping, and roadmap creation. It writes PROJECT.md, REQUIREMENTS.md, ROADMAP.md, and STATE.md into a .planning directory.

What files does the new project initialization workflow create?▼

It creates .planning/PROJECT.md for context, .planning/config.json for workflow preferences, .planning/REQUIREMENTS.md for scoped requirements, .planning/ROADMAP.md for phase structure, .planning/STATE.md for project memory, and optionally .planning/research/ for domain research.

Can I run project initialization without interactive questions?▼

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

What should I do after initializing a project with this workflow?▼

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 between sessions.

When is the optional research step useful in project setup?▼

The research step is useful when entering an unfamiliar domain or validating technical approaches. It stores findings in .planning/research/ so requirements and roadmap decisions are grounded in documented evidence.

Related Skills

Explore More Product & Management Skills→
wsmanwsman
18

brainstorm

Guide collaborative ideation into a structured concept document.

Community
Advanced
landfilllandfill

feature-planner

Generate phase-based feature plans with quality gates and approval workflows.

Community
Advanced
onelee85onelee85

gsd-list-phase-assumptions

Analyze a project phase and surface assumptions about approach, order, scope, risks, and dependencies.

Community
Intermediate
tkstangtkstang

oat-project-quick-start

Scaffold OAT projects and generate executable plan.md files.

Community
Intermediate