What is an executable acceptance test?

Definition

An executable acceptance test turns part of a definition of done into a repeatable operation. It specifies the command, environment and success evidence needed to judge the result without relying on a narrative status report.

A trustworthy check requires both a successful process exit and the expected decisive output when output is part of the proof. The command itself must also be reviewed when it can change files, access credentials or affect external systems.

ELI5

An executable acceptance test is a command that checks whether a specific requirement has been met. It turns part of the definition of done into repeatable evidence instead of relying only on someone's claim that the work is complete.

For example, a test can open a sample order, apply a discount, and verify the exact total. The test must finish successfully and show the expected result, and reviewers should understand any files or systems the command can change.

Is a zero exit code enough for an executable acceptance test?

Not always. The command may exit successfully without proving the intended outcome, so relevant output or artifact evidence may also be required.

Why should acceptance commands be stored before work begins?

Predefining them makes the completion standard visible and prevents an agent from choosing an easier check after seeing its implementation.

  1. Prove It - Then Report Done above a flat acceptance-checklist illustration
  2. Portraits of David Ondrej, Alex Lieberman and Dan Zakon beside the words Context Is the System
    Context as Code for Agentic Engineering
    David Ondrej51m 54s2 VIEWS
  3. Theo Browne beside the words Delete the Memory
Definition card for executable acceptance test: What is an executable acceptance test?

An executable acceptance test is a runnable command or test that determines whether a defined acceptance condition has been met.