Skip to main content
Software changes faster than shared understanding among the people building it. That is the core problem. Spec Led Development helps teams document intent, build with it, and verify it as the code changes.

​
The problem

When shared understanding slips, teams get:
  • code that passes tests but still misses the point
  • docs that go stale
  • AI changes with weak context
  • behavior that drifts over time

​
The loop

Keep one small loop alive:
  1. Write one spec for one important thing.
  2. Build code, tests, and docs from that spec.
  3. Run one check locally and again in CI.
Humans stay in the loop. Specs keep the intent close to the code.

​
Start here

Get started

See the simplest starter flow.

What is Spec Led?

Read the plain-language version.

Theory

Learn why specs need a verification loop.

Specification

See the core file shape.

How it grows

See how teams add structure later.

Beta plan

See what we are planning to ship first.