bdd-collaboration

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

⭐47stars🔀5forks📁View on GitHub🕐Updated Jan 2, 2026⬇️1downloads

When & Why to Use This Skill

This Claude skill facilitates Behavior-Driven Development (BDD) collaboration by bridging the communication gap between developers, testers, and business stakeholders. It streamlines the software development lifecycle by providing structured frameworks for Three Amigos sessions, Example Mapping, and discovery workshops, ensuring that requirements are clearly understood and testable before a single line of code is written.

Use Cases

  • Three Amigos Sessions: Facilitate collaborative meetings between Product Owners, Developers, and QA to align on feature behavior and identify edge cases early.
  • Example Mapping: Conduct structured discovery sessions to break down complex user stories into concrete rules, examples, and questions using a visual mapping approach.
  • Living Documentation: Generate and maintain Gherkin-style scenarios that serve as both human-readable requirements and a foundation for automated acceptance tests.
  • Ubiquitous Language Development: Build and document a shared domain vocabulary to eliminate terminology confusion between technical teams and business stakeholders.
  • Discovery Workshops: Lead time-boxed sessions to explore new features, document shared understanding, and prevent defects through proactive discussion.
namebdd-collaboration
descriptionUse when facilitating BDD collaboration between developers, testers, and business stakeholders. Use when running discovery workshops and example mapping sessions.

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:

# 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 within the last 30 days.
  "Winback" is re-activating a churned subscriber.

  Scenario: Winback offer for churned subscriber
    Given a churned subscriber from 15 days ago
    When they visit the pricing page
    Then they should see the winback offer

Living Documentation

Feature: Payment Processing

  # Link to business documentation
  @jira:PAY-123
  @confluence:payment-rules

  # Version tracking
  @since:v2.1

  Scenario: Process credit card payment
    # This scenario documents the current behavior
    # Last verified: 2024-01-15

When to Use This Skill

Use bdd-collaboration when you need to:

  • Align team understanding of requirements
  • Reduce miscommunication between roles
  • Create shared ownership of quality
  • Build domain knowledge across team
  • Prevent defects through early discussion

Best Practices

  • Schedule regular Three Amigos sessions
  • Use Example Mapping for complex stories
  • Create and maintain a domain glossary
  • Keep scenarios as living documentation
  • Involve stakeholders in scenario reviews
  • Time-box discovery sessions

Common Pitfalls

  • Skipping collaboration and writing scenarios alone
  • Not including all three perspectives
  • Using technical jargon with business stakeholders
  • Letting scenarios become outdated
  • Over-documenting simple features
  • Not following up on questions raised