Subplot alpha logo

Latest from the project

When all stakeholders really need to understand acceptance criteria

Capture and communicate acceptance criteria for software and systems, and how they are verified, in a way that’s understood by all project stakeholders.

Subplot is a set of tools for specifying, documenting, and implementing automated acceptance tests for systems and software. Subplot tools help produce a human-readable document of acceptance criteria and a program that automatically tests a system against those criteria.

Subplot is currently in its ALPHA stage.


Subplot is a community project: it is developed by some people who want to do it. You could help!

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.


This is a pretty minimal example.

See actual, working, tested examples:

  • The Unix echo command (html, PDF, source).

  • A hypothetical JSON store with access control and a web API (html, PDF, source).

  • Subplot’s own acceptance criteria, a non-trivial example (html, PDF, source).

The examples site may have more examples, if we forget to list them here. These are generated automatically from the Subplot source repository by CI, so they’re always up to date, and tested as part of Subplot’s CI build, so they always work.

A bonus kitten

Because you scrolled all the way down.

Kitten being adorable. By Ckahler on English Wikipedia