Getting Started with SpecD

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.

---

Guides

• 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