sdd

Appearance

Build a simple feature ​

You’re shipping a real feature, not a one-line typo. You want a short plan next to the PR — without a heavy enterprise process.

Best forNormal product work on an existing app
You’ll getA folder under changes/ + code + a local check
First time with sdd?Do the 10-minute tutorial first

Brand-new product from a one-liner? → Greenfield, then come back (or use sdd feature start F-001).

1. One-time setup ​

bash
cd your-app
sdd init --here --ai copilot    # or grok | claude | ollama
sdd doctor

2. Start the feature ​

bash
sdd new "Add CSV export for reports" -w feature -y

The title can also recommend a workflow if you omit -w feature.

3. Walk the stages ​

Rough flow (you can skip optional steps):

bash
# 1) Open feature.md — write who it's for, scope, non-goals, success
sdd next

# optional skips if a step doesn't apply:
# sdd skip clarify_intent -r "clear enough"
# sdd skip brainstorm -r "one clear approach"

# 2) design.md — how you'll build it
sdd next

# 3) tasks.md — checklist
sdd next

# 4) implement — write the code (you or the AI)
sdd next

# 5) check it works
sdd verify
sdd complete

Example feature.md (paste and edit) ​

markdown
# Feature

Users need to download the current report as CSV for offline analysis.

## Users
Analysts who already can view the report in the app.

## Scope
- Export visible columns for the filtered result set
- Stream large results

## Non-goals
- PDF export
- Scheduled email of exports

## Success
Download completes for 10k rows without timeout; file opens in Excel.

Empty templates block you

sdd next wants real sentences (like above), not blank bullets. That’s intentional.

Handy extras ​

bash
sdd refine                 # improve the current notes
sdd context --path … --symbol …   # focused code slices for the AI
sdd next --no-agent        # move stages without launching AI