Skip to content

New product from a one-line idea

You have a sentence, not a backlog. Greenfield helps you write a small product plan before you drown in code — then you build one feature at a time.

Best forEmpty repo / brand-new MVP
You’ll getNotes in memory/ + a list of features like F-001
Not forA single bug on an existing app → use simple feature or a hotfix

Picture it: idea → short plan → list of features → simple architecture → implement F-001, F-002, …


When to use which path

SituationCommand
New productsdd greenfield "…"
Feature on existing appSimple feature
Tiny fixsdd new "…" -w hotfix -y

1. One-time setup

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

2. Start from your idea

bash
sdd greenfield "Team expense tracker for remote startups"

You’ll walk four steps (fill a short file each time):

  1. Vision — who is it for, problem, how you know MVP worked
  2. Requirements — clear “must / should” statements
  3. Features — small items F-001, F-002, … (one PR each)
  4. Architecture — simple system shape (keep it modest)
bash
# After writing each file:
sdd next
# … until architecture is done …
sdd complete

When you complete, good content is copied into memory/ so later work can reuse it:

You wroteSaved as
visionmemory/product.md
requirementsmemory/requirements.md
featuresmemory/features.md
architecturememory/architecture.md

3. Build features one by one

bash
sdd feature list
sdd feature start F-001
# normal loop: notes → sdd next → code → sdd verify → sdd complete
sdd feature start F-002

Each start creates a normal change folder and marks that backlog row in progress.


How to write a feature row

markdown
## F-001: Capture expense

- **Status:** planned
- **Priority:** must
- **Workflow:** feature
- **Summary:** User adds amount, category, and photo receipt.
- **Requirements:** R-001
- **Notes:** Mobile first

Headings must look like ## F-001: Short name so the tool can read them.


Friendly tips

  • Keep vision small — the smallest useful product.
  • One feature ≈ one PR.
  • Blank templates don’t get saved into memory — write real sentences.
  • First time with sdd? The 10-minute tutorial still helps.

Limits (v1)

Works todayNot automatic yet
List and start F-001…Marking features done when a pack completes
Promote plan into memorySyncing edits both ways forever
Choose workflow per featureMultiple products in one repo

When a feature ships, set Status to done in memory/features.md by hand (for now).