What problem does it solve?
Provides a clear, enforceable testing discipline to prevent ambiguous "works-for-me" outcomes, reduce flaky tests, and ensure the main branch remains reliably green by specifying desired behavior before implementation.
Core Features & Use Cases
- TDD Workflow Enforcement: Mandates red→green→refactor, writing failing specs first for features, bug fixes, and interface changes.
- Cucumber/Gherkin Guidance: Prescribes domain-focused feature files for UI/UX bugs and keeps step definitions responsible for UI mechanics.
- Flaky Test Triage & Suite Health: Defines how to investigate flaky specs, gather context (command, failure output, failure rate), and prioritize remediation to restore trust in the suite.
- Use Case: When a CI job fails intermittently, follow the flaky-test procedure to collect failure context, propose a dedicated investigation, and prevent masking with retries.
Quick Start
Write a failing spec that reproduces the desired behavior or bug, implement the minimal change to make it pass, then refactor while keeping the entire suite green.