bdd-principles

Guides writing Given/When/Then scenarios and acceptance criteria using behavior-driven development principles.

Updated May 26, 2026
One-click install
npx skills add https://github.com/robot-denny/ai-sketchlab --skill bdd-principles-robot-denny
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bdd-principles
Source: https://github.com/robot-denny/ai-sketchlab/tree/main/.agents/skills/bdd-principles
Command: npx skills add https://github.com/robot-denny/ai-sketchlab --skill bdd-principles-robot-denny

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams often build the wrong thing because requirements are vague, ambiguous, or understood differently by business and technical stakeholders. This Skill helps you express requirements as concrete, observable behaviors in shared business language before any code is written. ## Core Features & Use Cases - Scenario Authoring Guidance: Write Given/When/Then scenarios that describe observable behavior in domain vocabulary, grouped under business rules. - Collaborative Discovery Practices: Run Three Amigos sessions and Example Mapping workshops to surface rules, examples, and open questions. - Living Documentation: Turn scenarios into executable specifications that double as up-to-date documentation and a regression safety net. - Use Case: When drafting acceptance criteria for a password reset feature, use this Skill to structure a Three Amigos conversation and produce scenarios covering token expiry, repeated requests, and non-existent emails. ## Quick Start Ask the AI to help you write BDD scenarios and acceptance criteria for your feature using Given/When/Then format and ubiquitous language.

Frequently Asked Questions about bdd-principles

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write good BDD scenarios in Gherkin?

Write scenarios in Given/When/Then format describing observable behavior in business language, not technical implementation details. Group related scenarios under business rules, use concrete examples with real values, and keep each scenario focused on a single behavior.

What is the difference between BDD and TDD?

BDD is business-focused and uses collaborative examples to define what to build, while TDD is developer-focused and uses unit tests to guide how to build it. They complement each other: BDD drives outside-in development from user behavior, TDD drives inside-out code design.

When should a scenario be a BDD scenario versus a unit test?

BDD scenarios should document key business behaviors and rules that stakeholders care about, while unit tests cover technical details and edge cases. If a scenario describes implementation mechanics rather than observable business behavior, it belongs at the unit test level.

How do I run a Three Amigos session for requirements?

Bring together business, development, and testing perspectives to explore a feature through concrete examples before implementation. Each role challenges assumptions: business defines value and rules, developers raise constraints, testers probe edge cases and failure modes.

What is Example Mapping in BDD?

Example Mapping is a workshop technique using four card colors: yellow for stories, blue for rules, green for example scenarios, and red for open questions. It structures discovery conversations and quickly reveals ambiguities and unknowns in a feature.

Is BDD just testing with Cucumber?

No, BDD is a collaborative practice for discovering requirements through conversation and examples; tools like Cucumber only automate the resulting scenarios. The core value is shared understanding between business and technical teams, not the tooling.