SpecD is a spec-driven development platform. It gives you a structured way to define what you want to build before you build it, track that definition as it evolves, and ensure the implementation matches what was agreed — especially when AI agents are doing the implementing.
This guide opens with the philosophy behind spec-driven development. Understanding the why makes the how much clearer. Technical concepts and project setup follow.
- Philosophy — The why behind spec-driven development
- Core Concepts — Specs, changes, artifacts, schema, workspaces, spec IDs
- Project Structure — How files are organized on disk
- Spec Directory — What's inside a spec directory
- Change Directory — What's inside a change directory
- Lifecycle — The change lifecycle at a glance
- Spec Metadata — Extracted metadata from spec files
- Context Compilation — How context is assembled for agents
- Usage in Practice — How SpecD is used with coding assistants
- Setting Up — Setting up a new project
- Local Site — Viewing the public site locally