Back to Skills

bdd-collaboration

verified

Use when facilitating BDD collaboration between developers, testers, and business stakeholders. Use when running discovery workshops and example mapping sessions.

View on GitHub

Marketplace

han

TheBushidoCollective/han

Plugin

jutsu-bdd

Technique

Repository

TheBushidoCollective/han
60stars

jutsu/jutsu-bdd/skills/bdd-collaboration/SKILL.md

Last Verified

January 24, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/TheBushidoCollective/han/blob/main/jutsu/jutsu-bdd/skills/bdd-collaboration/SKILL.md -a claude-code --skill bdd-collaboration

Installation paths:

Claude
.claude/skills/bdd-collaboration/
Powered by add-skill CLI

Instructions

# BDD Collaboration

Master the collaborative aspects of Behavior-Driven Development to bridge communication between technical and business teams.

## Three Amigos Sessions

The Three Amigos brings together three perspectives:

- **Business/Product**: Defines the desired behavior
- **Development**: Understands implementation implications
- **Testing/QA**: Identifies edge cases and risks

```
Session Structure:
1. Product Owner presents the user story
2. Developer asks clarifying questions
3. Tester identifies potential edge cases
4. Team writes scenarios together
5. Everyone agrees on acceptance criteria
```

## Example Mapping

Example Mapping is a structured conversation technique:

```
┌─────────────────────────────────────────┐
│ STORY: As a customer, I want to...      │ (Yellow card)
├─────────────────────────────────────────┤
│ RULE: Orders over $50 get free shipping │ (Blue card)
│   ├── Example: $60 order = free         │ (Green card)
│   ├── Example: $49 order = $5 shipping  │ (Green card)
│   └── Question: What about $50 exactly? │ (Red card)
├─────────────────────────────────────────┤
│ RULE: Express shipping always costs $15 │ (Blue card)
│   ├── Example: $100 order express = $15 │ (Green card)
│   └── Example: $30 order express = $15  │ (Green card)
└─────────────────────────────────────────┘
```

## Discovery Workshop Format

```
1. INTRODUCE (5 min)
   - Present the feature or story
   - Share any existing context

2. EXPLORE (20 min)
   - "What are the rules?"
   - "Can you give me an example?"
   - "What could go wrong?"

3. DOCUMENT (15 min)
   - Write scenarios together
   - Capture questions for later

4. REVIEW (10 min)
   - Read scenarios aloud
   - Confirm shared understanding
```

## Ubiquitous Language

Build a shared vocabulary:

```gherkin
# Domain terms defined clearly
Feature: Subscription Management

  # Define terms in feature description
  A "subscriber" is a customer with an active subscription.
  A "churned subscriber" has cancelled

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
3244 chars