What it does
Gherkin Guidelines for AI is an open-source Markdown file (gherkin-guidelines.md) designed to be added as shareable context so that AI coding tools generate higher-quality Gherkin and BDD test scenarios. Rather than a skill or agent that runs actions, it's a ruleset: a document of guidance an agent reads before writing Gherkin.
How QA teams use it
- Drop the guidelines file into an agent's context — a
CLAUDE.md, a rules file, or attached context — so any generated Gherkin follows good BDD practices. - Use it to steer agents toward declarative steps, proper Given/When/Then structure, and reusable scenarios instead of overly implementation-specific steps.
- Share it across a team's tooling (Claude Code, Cursor, Codex) so Gherkin output stays consistent regardless of which agent authored it.
Notes
Authored by Andy Knight (AutomationPanda), a recognized voice in the BDD/Gherkin testing community. It's a context document, not an executable tool.