Egor Urvanov

Spec-Driven Development

Specs and architecture · SDD

An approach where a specification — what the system must do — is written first, and an agent writes the code and checks it against the spec. The spec becomes the main document and the code its consequence.

youspecwhat the system must doagentcodefollows the specyou writereadswriteschecks code against the spec● model, people, systems, data  ● agent and harnessSpec first, code follows; the agent writes code and checks it against the spec

Reconcile loop: Kubernetes and the agent

KubernetesSpec-Driven Development
Desiredmanifests, a Helm chartthe spec
Actualservices in the clustercode in the repository
Who comparesa controllerthe agent
What it does on a mismatchstarts or removes podsedits code until tests and spec agree
How to change the systemedit the manifest, not the clusteredit the spec, not the code

Source: GitHub Blog: Spec-driven development

Where it appears · 1

Related terms

Whole glossary

© 2026 Egor Urvanov