Skip to content

sdd new

Creates a new feature specification.

Usage

bash
sdd new <name> [options]

Arguments

ArgumentDescription
nameFeature name (English, kebab-case recommended)

Options

OptionDescription
-d, --domain <domain>Specify domain (v1.3.0)
--allGenerate spec, plan, and tasks

Generated Files

.sdd/specs/<domain>/<name>/
├── spec.md     # Feature specification
├── plan.md     # Implementation plan (with --all)
└── tasks.md    # Task breakdown (with --all)

v1.3.0 Domain-Based Structure

  • If no domain is specified, files are created in the common folder
  • Example: sdd new login -d auth.sdd/specs/auth/login/spec.md

Examples

Basic Creation (common domain)

bash
sdd new user-auth
# → .sdd/specs/common/user-auth/spec.md

Create with Domain

bash
sdd new login -d auth
# → .sdd/specs/auth/login/spec.md

Create All Files

bash
sdd new user-auth --all -d auth
# → .sdd/specs/auth/user-auth/spec.md, plan.md, tasks.md

Subcommands

sdd new plan

Create only the implementation plan:

bash
sdd new plan user-auth

sdd new tasks

Create only the task breakdown:

bash
sdd new tasks user-auth

Generated spec.md Example

markdown
---
id: user-auth
title: "user-auth"
status: draft
created: 2025-12-24
---

# user-auth

> Write the feature description here

## Requirements

### REQ-01: Requirement Title

The system SHALL ...

## Scenarios

### Scenario 1: Scenario Title

- **GIVEN** precondition
- **WHEN** action
- **THEN** expected result

MIT License