deliberate.codes

Practical AI for data & software engineers. What works, no hype.

Spec-Driven Development with AI agents

How I turn prompts into working and tested software with AI coding agents

Spec-driven development (SDD) is the foundational discipline for agentic software engineering. Coding agents drift without clear requirements and scenarios. SDD is a systematic approach to formalize intent so that coding agents are able to reliably generate working software. speq-skill is my open-source workflow and harness for agentic engineering with SDD.

Read the series in order:

  1. Spec-driven development: an introduction — what SDD is, and a practical comparison of GitHub Spec-Kit, Fission-AI OpenSpec, and AgentOS.
  2. A cure for the vibe coding hangover — why vibe coding does not scale and what agentic engineering with SDD fixes.
  3. Writing specs for AI coding agents — BDD-style scenarios + RFC 2119 keywords, in practice.
  4. Introducing speq-skill — my workflow and harness for agentic engineering with spec-driven development.
  5. Collaborative agentic engineering — how teams can leverage agentic engineering with spec-driven development.