bdd-principles

Conduct Three Amigos sessions and produce executable scenarios for BDD workflows.

187|20|Updated Nov 20, 2025
One-click install
npx skills add https://github.com/TheBushidoCollective/han --skill bdd-principles
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bdd-principles
Source: https://github.com/TheBushidoCollective/han/tree/main/jutsu/jutsu-bdd/skills/bdd-principles
Command: npx skills add https://github.com/TheBushidoCollective/han --skill bdd-principles

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Master foundational BDD concepts, philosophy, and Three Amigos practice for shared understanding.

Core Features & Use Cases

  • Discovery > Development > Delivery workflow
  • Three Amigos collaboration across business, development, and testing
  • Living documentation through executable specifications

Quick Start

Conduct a Three Amigos session for a new feature and produce three executable scenarios illustrating the feature.

Frequently Asked Questions about bdd-principles

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

FAQPage Schema
What is behavior-driven development and how does it bridge business and technical teams?

Behavior-driven development (BDD) solves the gap between business and technical teams by using shared, executable specifications of system behavior. It replaces ambiguous requirements with concrete examples that both business stakeholders and developers understand, turning those examples into automated tests that serve as living documentation.

How do I run a Three Amigos discovery session for a new feature?

Conduct a Three Amigos session by bringing together a business analyst, developer, and tester to collaboratively discuss a feature using concrete examples. Document the agreed-upon scenarios, then turn them into executable specifications that automatically validate the feature as it's built and maintained.

What's the difference between BDD and writing test cases after development?

BDD reverses the workflow: examples drive development from the start through the Discovery > Development > Delivery cycle. This produces executable specifications that stay current as behavior evolves, replacing static test cases written after code is complete and prone to becoming stale.

Can I use BDD to keep documentation current without manual updates?

Yes. BDD creates living documentation through executable specifications that automatically reflect actual system behavior. When behavior changes, the tests fail immediately, forcing documentation and code to stay in sync—no manual updates needed.

Do I need special tools or frameworks to practice BDD principles?

BDD principles—collaborative discovery, concrete examples, and executable specifications—are framework-agnostic. The core practice is the Three Amigos workflow and example-driven thinking; specific tools implement these principles but aren't prerequisites for learning and applying BDD fundamentals.

How do concrete examples become automated tests in BDD?

In BDD, the concrete examples produced during Three Amigos sessions are written in structured, executable format (scenarios with given-when-then steps). These scenarios are directly translated into automated test code that validates system behavior, eliminating the translation gap between requirements and tests.