bdd-conventions

Standardize Story and Scenario formatting with SC-XX-YY numbering and contract rules.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/hiiamsky/multi-agent-dev-team --skill bdd-conventions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bdd-conventions
Source: https://github.com/hiiamsky/multi-agent-dev-team/tree/main/.github/skills/bdd-conventions
Command: npx skills add https://github.com/hiiamsky/multi-agent-dev-team --skill bdd-conventions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

BDD conventions ensure all three agents (SA/SD, E2E, QA/QC) speak the same language when crafting and validating behavior-driven requirements. By enforcing a single format for Story and Scenario definitions, SC-XX-YY numbering, and contract derivations, teams avoid misinterpretations and drift.

Core Features & Use Cases

  • Unified Story and Scenario structure for cross-team alignment
  • SC-XX-YY numbering scheme with clear traceability
  • Frozen Contract declarations and API contract derivation rules for consistent interface expectations

Quick Start

Create a BDD blueprint file following the defined Story and Scenario format and ensure SC-XX-YY numbering for all stories and scenarios.

Frequently Asked Questions about bdd-conventions

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

FAQPage Schema
How do I standardize BDD scenarios across multiple teams?

To standardize BDD scenarios across SA/SD, E2E, and QA/QC, use a unified Story and Scenario structure with SC-XX-YY numbering to ensure consistent definitions and traceability across agents.

What is a Frozen Contract declaration in BDD specifications?

A Frozen Contract declaration in BDD specifications defines API contract derivation rules to maintain a single source of truth for interface expectations across SA/SD writers and E2E tests.

How do I map E2E tests to BDD stories and scenarios?

You map E2E tests to BDD stories and scenarios by applying SC-XX-YY numbering and Frozen Contract declarations, ensuring E2E test mapping aligns directly with the unified Story and Scenario format.

How does QA validate full scenario coverage for BDD requirements?

QA validates full scenario coverage for BDD requirements by enforcing the single source of truth provided by the standardized Story and Scenario structure and the SC-XX-YY numbering scheme.

When do I need SC-XX-YY numbering for behavior-driven development?

You need SC-XX-YY numbering for behavior-driven development when cross-team alignment is required, as it provides clear traceability for all stories and scenarios across SA/SD, E2E, and QA/QC agents.

Does standardizing BDD conventions prevent drift between agents?

Standardizing BDD conventions prevents drift between agents by ensuring SA/SD, E2E, and QA/QC speak the same language, enforcing a single format for Story and Scenario definitions and contract derivations.