create-spec

Create Spec

Generate a new feature specification following the Spec-Driven Development template.

Usage

/create-spec [feature_name]

Example: /create-spec notifications

Instructions

When this command is invoked:

1. Gather requirements from the user:

   • Ask clarifying questions about the feature
   • Understand the problem being solved
   • Identify constraints and dependencies

2. Read existing specs for context:

   • specs/01_product_manager.md - Product vision and principles
   • specs/02_backend_lead.md - Backend patterns
   • specs/03_frontend_lead.md - Frontend patterns
   • specs/04_db_architect.md - Database conventions

3. Determine spec number:

   • Check existing specs in specs/ folder
   • Use next available number (e.g., 10, 11, etc.)
   • Feature specs start at 10+

4. Generate spec document with these sections:

# SPEC: [Feature Name]

**Version:** 1.0
**Created:** [Date]
**Status:** Draft

---

## 1. Vision

### Problem Statement
What problem does this solve?

### Success State
What does success look like?

### Who Benefits
Which users benefit from this feature?

---

## 2. Requirements

### Functional Requirements

| ID | Requirement | Priority | Notes |
|----|-------------|----------|-------|
| FR-1 | [Requirement] | Must Have | |
| FR-2 | [Requirement] | Should Have | |
| FR-3 | [Requirement] | Nice to Have | |

### Non-Functional Requirements

| ID | Requirement | Metric |
|----|-------------|--------|
| NFR-1 | Performance | [Target] |
| NFR-2 | Security | [Standard] |
| NFR-3 | Scalability | [Target] |

---

## 3. Database Schema (if applicable)

```sql
-- New tables or alterations
CREATE TABLE feature_table (
  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
  -- columns
  created_at TIMESTAMPTZ DEFAULT NOW(),
  updated_at TIMESTAMPTZ DEFAULT NOW()
);

CREATE INDEX idx_feature_table_... ON feature_table(...);

---

4. API Endpoints (if applicable)

Method	Endpoint	Description	Auth
GET	/api/v1/...	Get items	Yes
POST	/api/v1/...	Create item	Yes

Request/Response Examples

GET /api/v1/feature

// Response
{
  "data": [],
  "meta": {
    "total": 0,
    "page": 1
  }
}

POST /api/v1/feature

// Request
{
  "field": "value"
}