edf9d0be6f
33 markdown files organized for GitBook import with SUMMARY.md navigation. Covers installation, core concepts, auto mode, configuration, all providers, cost management, skills, parallel orchestration, remote questions, teams, headless CI, and full command reference. User-facing only — no internal/dev content. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
128 lines
3.5 KiB
Markdown
128 lines
3.5 KiB
Markdown
# Your First Project
|
|
|
|
## Launch GSD
|
|
|
|
Open a terminal in any project directory (or an empty one) and run:
|
|
|
|
```bash
|
|
gsd
|
|
```
|
|
|
|
GSD shows a welcome screen with your version, active model, and available tool keys.
|
|
|
|
## Start a Discussion
|
|
|
|
Type `/gsd` to enter step mode. GSD reads the state of your project directory and determines the next logical action:
|
|
|
|
- **No `.gsd/` directory** — starts a discussion flow to capture your project vision
|
|
- **Milestone exists, no roadmap** — discuss or research the milestone
|
|
- **Roadmap exists, slices pending** — plan the next slice or execute a task
|
|
- **Mid-task** — resume where you left off
|
|
|
|
For a new project, GSD will ask you to describe what you want to build. Talk through your vision — GSD captures requirements, architectural decisions, and scope.
|
|
|
|
## The Project Hierarchy
|
|
|
|
After discussion, GSD organizes your work into:
|
|
|
|
```
|
|
Milestone → a shippable version (4-10 slices)
|
|
Slice → one demoable feature (1-7 tasks)
|
|
Task → one context-window-sized unit of work
|
|
```
|
|
|
|
The key rule: **a task must fit in one AI context window.** If it can't, it becomes two tasks.
|
|
|
|
## Run Auto Mode
|
|
|
|
Once you have a milestone and roadmap, let GSD take the wheel:
|
|
|
|
```
|
|
/gsd auto
|
|
```
|
|
|
|
GSD autonomously:
|
|
1. **Plans** each slice — scouts the codebase, researches docs, decomposes into tasks
|
|
2. **Executes** each task — writes code in a fresh AI session
|
|
3. **Completes** the slice — writes summaries, commits with meaningful messages
|
|
4. **Reassesses** the roadmap — checks if the plan still makes sense
|
|
5. **Repeats** until the milestone is done
|
|
|
|
## The Two-Terminal Workflow
|
|
|
|
The recommended approach: auto mode in one terminal, steering from another.
|
|
|
|
**Terminal 1 — let it build:**
|
|
|
|
```bash
|
|
gsd
|
|
/gsd auto
|
|
```
|
|
|
|
**Terminal 2 — steer while it works:**
|
|
|
|
```bash
|
|
gsd
|
|
/gsd discuss # talk through architecture decisions
|
|
/gsd status # check progress
|
|
/gsd queue # queue the next milestone
|
|
/gsd capture "add rate limiting to the API" # fire-and-forget thought
|
|
```
|
|
|
|
Both terminals read and write the same `.gsd/` files. Decisions in terminal 2 are picked up at the next phase boundary automatically.
|
|
|
|
## Check Progress
|
|
|
|
Press `Ctrl+Alt+G` or type `/gsd status` to see the dashboard:
|
|
|
|
- Current milestone, slice, and task
|
|
- Elapsed time and phase
|
|
- Per-unit cost and token breakdown
|
|
- Completed and in-progress work
|
|
|
|
## Resume a Session
|
|
|
|
```bash
|
|
gsd --continue # or gsd -c
|
|
```
|
|
|
|
Resumes the most recent session for the current directory.
|
|
|
|
To browse and pick from all saved sessions:
|
|
|
|
```bash
|
|
gsd sessions
|
|
```
|
|
|
|
Shows each session's date, message count, and preview so you can choose which to resume.
|
|
|
|
## What's on Disk
|
|
|
|
All state lives in `.gsd/` inside your project:
|
|
|
|
```
|
|
.gsd/
|
|
PROJECT.md — what the project is
|
|
REQUIREMENTS.md — requirement contract
|
|
DECISIONS.md — architectural decisions
|
|
KNOWLEDGE.md — cross-session rules and patterns
|
|
STATE.md — quick-glance status
|
|
milestones/
|
|
M001/
|
|
M001-ROADMAP.md — slice plan with dependencies
|
|
M001-CONTEXT.md — scope and goals
|
|
slices/
|
|
S01/
|
|
S01-PLAN.md — task decomposition
|
|
S01-SUMMARY.md — what happened
|
|
S01-UAT.md — test script
|
|
tasks/
|
|
T01-PLAN.md
|
|
T01-SUMMARY.md
|
|
```
|
|
|
|
## Next Steps
|
|
|
|
- [Auto Mode](../core-concepts/auto-mode.md) — deep dive into autonomous execution
|
|
- [Preferences](../configuration/preferences.md) — model selection, timeouts, budgets
|
|
- [Commands](../reference/commands.md) — all commands and shortcuts
|