LEONEL KREA
← All reviews
Methodology

Spec-Driven Development

5.0 / 5

Specify before coding: the spec is the source of truth and the code its consequence. My way of building product as a system.

It's not a tool, it's a way of working: before writing code, I write what has to exist and why. The specification stops being documentation that ages and becomes the origin from which everything else flows.

The real benefit is that knowledge stops living only in my head. Anyone (or an AI) can read the spec and know what to build and where it fits. This very site is a case in point: the Context rules and the code is its consequence.

It has a cost: it demands discipline to keep the spec in sync, and a validator that stops code and documentation from contradicting each other. In exchange, you scale without becoming the bottleneck.

PROS

  • Knowledge stops depending on a single person
  • Documentation that doesn't age: it's the source of truth
  • Onboarding (human or AI) much faster
  • Traceable, reviewable decisions

CONS

  • It demands discipline to keep the spec up to date
  • It needs a validator that keeps code and spec from contradicting each other

Want to know more?

Take a look and draw your own conclusions.

Read how I apply it