Executable specification
An executable specification describes expected system behavior in a form that can be run or checked automatically.
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
- GherkinGherkin is a structured, human-readable domain-specific language for expressing software behavior as features and scenarios with steps such as Given, When, and Then.
- OpenAPI specificationThe OpenAPI Specification is a machine-readable standard for describing HTTP APIs, including their operations, inputs, outputs, data structures, and security requirements.
- software testingSoftware testing is the systematic evaluation of software under specified inputs or conditions to assess its behavior against expected results or requirements and identify defects.
- unit testA unit test is an automated test that checks whether a relatively small unit of software behaves as expected, typically in isolation from external dependencies.
Related concepts
- acceptance criteriaproduced by · Acceptance criteria are verifiable conditions that a requirement, feature, or deliverable must satisfy to be considered acceptable or complete.
- acceptance testingproduces · Acceptance testing evaluates whether a system satisfies specified user, business, or stakeholder requirements and acceptance criteria.
- Cucumberuses · Cucumber is a behavior-driven development tool that executes structured, human-readable specifications as automated tests by connecting their steps to step definitions.
- documentationpart of · Documentation is recorded explanatory, instructional, or reference material that describes a system, process, or subject and how it is used, understood, or maintained.
- living documentationproduces · Living documentation is documentation maintained or validated as a system evolves so that it remains aligned with the system, behavior, design, or decisions it describes.
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.

