Gherkin Guidelines for AI

A shareable Markdown ruleset that guides AI coding tools to write higher-quality Gherkin and BDD scenarios.

RulesetMulti-Agent RulesetVerified

View source

Category: BDD / Gherkin
Author: Andy Knight (AutomationPanda)
Pricing: free

Install Gherkin Guidelines for AI in your agent

https://raw.githubusercontent.com/AutomationPanda/gherkin-guidelines-for-ai/main/gherkin-guidelines.md

Add the ruleset
Download this Markdown file into your project or reference it from CLAUDE.md.
Finish setup
Tell Claude Code to read the guidelines before creating or reviewing Gherkin scenarios.
Try it
Ask your agent: “Write one declarative Gherkin scenario that follows the added guidelines.”

https://raw.githubusercontent.com/AutomationPanda/gherkin-guidelines-for-ai/main/gherkin-guidelines.md

Add the ruleset
Download this Markdown file into your project and attach it as Cursor context.
Finish setup
Reference @gherkin-guidelines.md when asking Cursor to create or review Gherkin scenarios.
Try it
Ask your agent: “Write one declarative Gherkin scenario that follows the added guidelines.”

https://raw.githubusercontent.com/AutomationPanda/gherkin-guidelines-for-ai/main/gherkin-guidelines.md

Add the ruleset
Download this Markdown file into your project or add it to the instructions Codex reads.
Finish setup
Tell Codex to follow the guidelines when creating or reviewing Gherkin scenarios.
Try it
Ask your agent: “Write one declarative Gherkin scenario that follows the added guidelines.”

https://raw.githubusercontent.com/AutomationPanda/gherkin-guidelines-for-ai/main/gherkin-guidelines.md

Add the ruleset
Download this Markdown file and add it as persistent project context in your agent.
Finish setup
Tell the agent to follow the guidelines when creating or reviewing Gherkin scenarios.
Try it
Ask your agent: “Write one declarative Gherkin scenario that follows the added guidelines.”

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, or Copilot) so Gherkin output stays consistent regardless of which agent authored it.