Executable markdown documentation for humans and agents. Turn your docs into tests.
Cucumber successor by the original author, addressing some main limitations and being more agent-friendly. Announcement here. Highlights:
I stopped using Cucumber for several reasons, but the most important ones are: * Gherkin is too stilted and constraining * Cucumber doesn't work well with other test runners (except on the JVM) * The editor support is poor During my past couple of years coding with agents I have missed something though. How can I know that the agent translated my prompts/specs/plans into what I intended? [...] With Vár you write Markdown. Without the straightjacket of Gherkin. I find it works particularly well for agents. It now has a way to verify its own work against the specification.
Aside of Markdown specs, you write tiny steps files in one of the supported languages (currently TS, Java, Kotlin, Python, Ruby), which translates the specs into runnable code. See this example spec and steps. It also supports tables and multi-line strings,










