doc-bdd

Purpose

Create Behavior-Driven Development (BDD) scenarios — Layer 4 of the SDD flow. A BDD suite translates EARS formal requirements into executable Given-When-Then (Gherkin) scenarios, each carrying cumulative trace tags and a spec_trace link forward to the SPEC sections it exercises.

Layer: 4. Upstream: BRD → PRD → EARS. Downstream: ADR → SPEC → TDD → IPLAN → Code.

BDD scenarios are the acceptance source of truth that TDD (Layer 7) maps to concrete test cases. Execution is QA-staging only — never run BDD in CI (use TDD unit/integration tests for CI).

When to Use

Use doc-bdd when: