SDD POC - Spec-Driven Development Proof of Concept

This is a proof-of-concept project exploring Spec-Driven Development (SDD) using GitHub's spec-kit.

Quick Start

# Clone the repo and open in Cursor
git clone https://github.com/Unik0rnMaggie/sdd-poc.git
cd sdd-poc
cursor .

# The following slash commands are available in Cursor:
# /speckit.constitution - Review/update project principles
# /speckit.specify      - Create a new feature specification
# /speckit.plan         - Create technical implementation plan
# /speckit.tasks        - Generate task breakdown
# /speckit.implement    - Execute implementation

Project Structure

.
├── .cursor/commands/     # Slash commands for Cursor IDE
├── .specify/
│   ├── memory/           # Project-wide context (constitution)
│   ├── specs/            # Feature specifications
│   └── templates/        # Spec templates
├── README.md             # This file
└── SDD-FINDINGS.md       # Research findings document

Sample Spec

A sample specification for the "Account Count Display" feature is available at: specs/account-count-display/spec.md

Demo Workflow

1. Review Constitution: /speckit.constitution - See project principles
2. Create Spec: /speckit.specify with a feature description (e.g. account count display)
3. Plan Implementation: /speckit.plan Use React with TypeScript, styled-components
4. Generate Tasks: /speckit.tasks
5. Implement: /speckit.implement

Key Files

• SDD-FINDINGS.md - Research findings
• .specify/memory/constitution.md - Project principles and guidelines
• specs/account-count-display/spec.md - Example feature spec (Account Count Display)

Resources

• GitHub spec-kit
• Martin Fowler: Understanding SDD