liveBook · Manning

Executable specification

An executable specification describes expected system behavior in a form that can be run or checked automatically.

How 2 Manning books explain it

BDD in Action, Second Edition

An executable specification is a business-readable description of expected software behavior that can be directly transformed into or executed as an automated check.

How it is used
Turns collaboratively agreed business examples into acceptance criteria that guide implementation, verify features, and document delivered behavior.
How deep it goes
Works through scenario wording, feature-file execution, automation, and maintenance changes, rather than stopping at a definition.
Examples
Uses train-departure scenarios, frequent-flyer points, and account-registration rules to make expected outcomes concrete.
What you can do after
Practice/perform writing business-readable scenarios, automating their checks, and updating them when requirements change.

Read how BDD in Action, Second Edition explains executable specification →

Vibe Engineering

A specification expressed in a form that can be executed or checked automatically to verify system behavior.

How it is used
Uses executable specifications as authoritative contracts for AI-generated code and verification gates.
How deep it goes
Works through test-suite and scenario-based contracts, their enforcement, and the risk of omitted requirements.
Examples
Uses ISBN-13 validation and a 30-day refund policy to expose formatting, checksum, time-boundary, and partial-refund cases.
What you can do after
Apply it via pytest or Gherkin scenarios to specify expected outcomes and check generated implementations.

Read how Vibe Engineering explains executable specification →

What to know first

Related concepts

Questions about executable specification

What is executable specification?

An executable specification describes expected system behavior in a form that can be run or checked automatically.

Which Manning books explain executable specification?

BDD in Action, Second Edition and Vibe Engineering.

What should I know before learning executable specification?

Manning books that teach executable specification usually introduce Gherkin, OpenAPI specification, software testing and unit test first.

What is executable specification part of?

Executable specification is part of documentation. Documentation is recorded explanatory, instructional, or reference material that describes a system, process, or subject and how it is used, understood, or maintained.

These guides are generated from the text of Manning books by Manning's knowledge graph and link to the sections they draw on. The full books are available on liveBook and at manning.com.