Egor Urvanov

Reconcile loop

Specs and architecture · as in Kubernetes

A loop in which a system keeps comparing the desired state with the actual one and brings the second to the first. Kubernetes works this way: manifests or a Helm chart describe which services must run, and a controller keeps checking that against the cluster and starts what is missing. Spec-Driven Development is the same: the desired state is the spec, the actual one is the code, and the agent brings the code to the spec.

Kubernetesdesiredmanifest, Helm chartactualservices in the clustercontroller↻ check againagentdesiredspecactualcodeagent↻ check again● model, people, systems, data  ● agent and harnessLike Kubernetes: compare desired with actual and converge, only for code

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: Kubernetes: Controllers

Where it appears · 2

Related terms

Whole glossary

© 2026 Egor Urvanov