reqnroll-testinglisted
Install: claude install-skill testland/qa
# reqnroll-testing
## Overview
Per [reqnroll-home][rh]:
[rh]: https://reqnroll.net/
> "**Reqnroll** is described as 'an open-source Cucumber-style BDD
> test automation framework for .NET. It has been created as a
> reboot of the SpecFlow project.'"
The "reboot" framing is the key: SpecFlow's maintenance slowed in
2023; the community forked into Reqnroll, which has continued
active development.
## When to use
- A new .NET project starts BDD - pick Reqnroll over SpecFlow.
- An existing SpecFlow project plans to migrate (SpecFlow-compatible;
see Step 9).
- The team needs full Gherkin support including Rule blocks
(per [reqnroll-home][rh]: "Full Gherkin support with tagged
Rule blocks").
For SpecFlow-locked legacy projects mid-migration (packages, bindings,
EOL background), see
[references/specflow-legacy.md](references/specflow-legacy.md).
## Worked example
A checkout team adds one BDD scenario, "Apply valid promo," to a new xUnit
project.
1. `dotnet add package Reqnroll.xUnit` and
`dotnet add package Reqnroll.Tools.MsBuild.Generation`.
2. `Features/Cart.feature` declares the scenario under
`Rule: Promo codes apply only when valid`, with
`When I enter "WELCOME10" in the promo input` / `Then the subtotal updates
to $22.49`.
3. `Steps/CartSteps.cs` binds each line - `[When(@"I enter ""([^""]*)"" in the
promo input")]` calls `_page.EnterPromoAsync(code)`, and the `Then` asserts
`Assert.Equal(22.49m, _page.GetSubtotal(), 2)`.
4. `dotnet test --fil