What problem does it solve?
This Skill addresses the challenge of specifications drifting from reality and tests being too noisy to validate quickly. It provides a way to create executable artifacts that serve as both specifications and tests, ensuring they stay in sync and are easily human-validatable.
Core Features & Use Cases
- Executable Specifications: Write specifications before implementation, driven by creating approval files that describe expected behavior.
- Human-Validatable Artifacts: Use domain-specific language and formats (like ASCII art for spatial problems or before/after for transformations) that allow for quick visual validation.
- Use Case: When designing a new feature, create approval files outlining user scenarios and expected outcomes. The implementation then focuses on making these specifications pass, ensuring the code directly reflects the intended behavior.
Quick Start
Use the bdd-with-approvals skill to create a new executable specification for the user login flow.