Code writes itself. Specs never will.

specdriven.com · Manifesto · Dialects · Landscape · Discord

---

specdriven.com is an open knowledge base from the Auto team. It covers the case for treating specifications as the most important artifact in software: why they matter, what they are, the manifesto, a catalog of spec dialects and tools, and discovery techniques teams use to figure out what to specify.

This repo is the source for the site. Go read it, then come back here to help make it better.

Contribute

Every page on the site has an Edit this page on GitHub link at the bottom.

• Fix something: See a typo, an unclear sentence, a broken link? Open a PR.
• Disagree with something? Open an issue or bring it to Discord. This is a good place to debate ideas, challenge claims, or suggest a different angle.
• Add a spec dialect: Building a structured specification language? Read the criteria and submit it.
• Join the conversation: Discord is where the community gathers.

Run locally

npm install
npm run dev

License

CC BY-NC-ND 4.0 · An initiative by Auto.