sdd-spec

Create structured SDD-lite spec.md files defining WHAT, WHY, and success criteria.

Updated Mar 28, 2026
One-click install
npx skills add https://github.com/rodacato/kwik-e-dev --skill sdd-spec-rodacato
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-spec
Source: https://github.com/rodacato/kwik-e-dev/tree/main/plugins/lifecycle/skills/sdd-spec
Command: npx skills add https://github.com/rodacato/kwik-e-dev --skill sdd-spec-rodacato

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

SDD-lite step 1 writes docs/sdd/<change-name>/spec.md describing WHAT we're building, WHY, and how we'll know it's done. It establishes the first artifact in the spec → plan → tasks → apply → verify chain and is intended for substantial changes where scope or success criteria are unclear or stakeholders disagree about what "done" looks like.

Core Features & Use Cases

  • Guides discovery and scoping by capturing WHAT, WHY, and HOW WE'LL KNOW before design or code
  • Produces a formal docs/sdd/<change-name>/spec.md template to drive planning and execution
  • Supports iterative refinement through a structured DISCOVERY → DRAFT SPEC → REVIEW workflow

Quick Start

Create docs/sdd/<change-name>/spec.md and begin drafting the Step 1 spec using the provided template.

Frequently Asked Questions about sdd-spec

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I document what we are building and why before starting implementation?

Drafting a structured spec defines WHAT, WHY, and success criteria before implementation. It captures project scope and stakeholder alignment by creating a formal spec.md document to drive subsequent planning and execution.

When do I need to write a formal specification for a project change?

A formal specification is needed for substantial changes with unclear scope or when stakeholders disagree on what done looks like. It establishes discovery details and open questions before any design or coding work begins.

How do I create a spec document for stakeholder alignment and change management?

Create a spec document by placing a spec.md file inside the docs/sdd directory. Use a defined template covering discovery, open questions, and references to guide iterative refinement through a structured drafting and review workflow.

What is the best way to manage scope and success criteria for unclear project changes?

Managing scope and success criteria is best handled by writing a structured SDD-lite spec. It captures the WHAT and HOW WE WILL KNOW details early, ensuring stakeholders agree on completion metrics before planning or coding starts.

Can I use a spec template for iterative refinement during project discovery?

Yes, the spec template supports iterative refinement through a structured discovery, draft spec, and review workflow. It allows you to continuously update open questions and references as project scope becomes clearer.

What should I not use a formal spec document for in the development process?

A formal spec document should not be used for minor changes with clear scope. It is specifically designed for substantial changes requiring stakeholder alignment, meaning trivial updates do not need this level of formal documentation.