What problem does it solve?
This Skill solves the critical problem of misalignment between business stakeholders, developers, and testers that leads to misunderstood requirements, costly rework, and delivered features that fail to meet business needs. It provides a structured, collaborative framework to define and validate system behavior before any code is written, ensuring all parties have a shared understanding of expected outcomes.
Core Features & Use Cases
- Three Amigos Alignment: Facilitate pre-development discovery sessions with business analysts, developers, and testers to align on feature requirements, edge cases, and acceptance criteria.
- Executable Gherkin Specifications: Write human-readable, machine-executable acceptance criteria using standard Gherkin syntax that non-technical business stakeholders can read and validate.
- Living Documentation: Maintain up-to-date, version-controlled system documentation that is automatically verified by passing test suites, eliminating stale requirement docs.
- BDD/TDD Integration: Seamlessly combine acceptance-level BDD scenarios with unit-level TDD workflows to ensure end-to-end behavior correctness from specification to implementation.
- Use Case Example: For a new e-commerce loyalty discount feature, use this Skill to run a Three Amigos session to align on discount rules, write Gherkin scenarios for edge cases like boundary order counts and stacked discount restrictions, and integrate those specs with your existing TDD workflow to guarantee the implementation matches the agreed business rules.
Quick Start
Use the bdd-specification skill to run a Three Amigos session for your new checkout feature and write aligned Gherkin acceptance scenarios that your product team can validate.
