Specification-Driven Development framework for agent-native development
SpecDD is an open-source framework designed to support specification-driven development in AI-assisted software projects by using human-readable .sdd files colocated with code. These specifications clarify intent, behavior, and constraints for both developers and AI agents, improving consistency and reducing errors. The framework is agent-agnostic, works with existing or new projects, and integrates directly into version control without vendor lock-in.
- ▪SpecDD uses small, local .sdd files to document code intent, architecture, and behavior alongside the code.
- ▪The framework is compatible with major AI coding agents like GitHub Copilot, Claude Code, and Amazon Q Developer.
- ▪SpecDD is agent-agnostic and stores specs in Git, avoiding plugin lock-in or proprietary formats.
- ▪It is experimental and recommends careful review of AI-generated outputs.
- ▪The SpecDD CLI supports setup and updates, requiring Node.js 22 or newer.
Opening excerpt (first ~120 words) tap to expand
SpecDDSpecDD™ is an open-source framework for specification-driven development in AI-assisted software projects.The SpecDD framework uses small, local, human-readable .sdd files that live beside the code they describe. These specs document intent, architecture, behavior, boundaries, and implementation tasks in a way that both human developers and AI coding agents can follow.SpecDD works for both greenfield and existing projects. In new projects, specs can define structure before implementation starts. In existing projects, specs can be introduced gradually around modules, services, features, or files that are actively changing.How it worksSpecDD is deliberately simple.
…
Excerpt limited to ~120 words for fair-use compliance. The full article is at SpecDD.