Skip to content

ADR 0008: BDD/TDD release gate

  • Status: Accepted
  • Date: 2026-09-11

Context

Critical paths (vouchers, consent, workshop pricing, the growth model maths) are business promises. With AI-assisted development at high speed, untested promises rot silently.

Decision

Critical-path features ship with both TDD (model/request specs pinning every rule) and BDD (system specs walking the user journey). The full portal suite runs before every deploy; a red suite blocks release. The PR template makes tests part of the definition of done in every app repo.

Consequences

The specs are the contract: ToS promises like "one voucher per company, ever" exist as executable assertions. Slower merges, far fewer regressions, and refactors stay cheap.