🚀 Getting Started 📚 Documentation ▶️ Example 📝 Changelog
## BDD in the Era of AI [Behavior-Driven Development (BDD)](https://cucumber.io/docs/bdd/) describes product requirements as `Given / When / Then` scenarios written in plain-text files. In the AI era, these scenarios become valuable artifacts for agents because they are both: * ✅ **Readable**: You can easily draft and refine scenarios with an agent to clearly define the behavior. * ✅ **Executable**: The same scenarios can be executed as automated tests to verify the implementation. Unlike plain Markdown specs, BDD does not just describe a feature; it makes the spec live and keeps it aligned with the codebase. Watch the
[1-minute workflow overview](https://www.youtube.com/watch?v=0bOdxvK1Tmk) or read the [blog post](https://vitalets.github.io/posts/bdd-agentic-workflow/) for more details on agentic BDD workflow.
Install the [playwright-bdd skill](https://vitalets.github.io/playwright-bdd/#/getting-started/agent-skill) to get started.
```diff
Feature: Agentic development
Scenario: Implement a new feature
Given business requirements
When a human defines the behavior as BDD steps
- Then the human implements the feature and verifies it with tests
+ Then the agent implements the feature and verifies it with tests
```
The ultimate goal: **review only feature files** and let automations check code quality and scenario compliance.
## Why Playwright Runner?
[Playwright](https://playwright.dev/) provides both browser automation APIs and a powerful test runner. Playwright-BDD converts `.feature` files into native Playwright tests, so you can use all Playwright runner capabilities:
- Automatic browser setup and cleanup
- Auto-waiting for page elements
- Auto-capture of screenshots, videos, and traces
- Parallel execution and sharding
- Built-in reports and visual comparison testing
- Playwright fixtures
- [...and more](https://playwright.dev/docs/library#key-differences)
## How It Works
## Extras
Playwright-BDD has several unique features:
- 🔥 Advanced tagging [by path](https://vitalets.github.io/playwright-bdd/#/writing-features/tags-from-path) and [special tags](https://vitalets.github.io/playwright-bdd/#/writing-features/special-tags)
- 🎩 [Step decorators](https://vitalets.github.io/playwright-bdd/#/writing-steps/decorators) for class methods
- 🎯 [Scoped step definitions](https://vitalets.github.io/playwright-bdd/#/writing-steps/scoped)
- ✨ [Exporting steps](https://vitalets.github.io/playwright-bdd/#/writing-features/chatgpt) for AI
- ♻️ [Re-usable step functions](https://vitalets.github.io/playwright-bdd/#/writing-steps/reusing-step-fn)
## Documentation
Check out the [documentation website](https://vitalets.github.io/playwright-bdd/#/).
## Demos
- Check out [`examples`](/examples) folder
- Clone the fully working repo: [playwright-bdd-example](https://github.com/vitalets/playwright-bdd-example)
## Playwright Versions Support
`playwright-bdd` supports the latest stable Playwright release and the **10 previous releases**.
## Changelog
Check out the latest changes in the [CHANGELOG.md](https://github.com/vitalets/playwright-bdd/blob/main/CHANGELOG.md).
## 💖 Sponsors
Great thanks to the **amazing people and companies** already supporting Playwright-BDD! Your help keeps the project alive and growing:
