How does the ADR-Ready score work?

It evaluates scenarios based on completeness, testability, architectural clarity, and business validation. A score of 90% or higher is required before creating downstream ADR artifacts.

Does it support complex test suite organization?

Yes, it enforces a section-based structure including index files, aggregators for large sections, and specific file naming patterns to prevent 'mega-files'.

What is the threshold registry integration?

It is a system that requires all quantitative values (like latency or limits) to be referenced via keys rather than hardcoded, ensuring scenarios stay in sync with performance requirements.

What is Layer 4 in the SDD workflow?

Layer 4 focuses specifically on BDD test scenarios, serving as the bridge between high-level business requirements (Layers 1-3) and technical system architecture (Layers 5-8).

Can I use this skill without existing BRD or PRD files?

No, this skill mandates upstream artifact verification. You must have existing documents in your docs/ folder to ensure valid traceability and requirement coverage.

Behavior-Driven Development Scenarios (doc-bdd)

Name: Behavior-Driven Development Scenarios (doc-bdd)
Author: vladm3105

byvladm3105

•

セキュリティとテスト

Generates structured Gherkin test scenarios with automated traceability and ADR-readiness scoring for SDD workflows.

The doc-bdd skill automates the creation of Layer 4 BDD artifacts within the SDD workflow, translating business and functional requirements from BRD, PRD, and EARS documents into executable Gherkin scenarios. It enforces a rigorous section-based architecture for managing large-scale test suites, ensures data-driven validation through threshold registries, and provides a unique 'ADR-Ready' scoring system to verify that requirements are sufficiently mature before progressing to system architecture and technical design.

主な機能

01Cross-layer traceability with mandatory @brd, @prd, and @ears tags

02Automated Gherkin scenario generation using Given-When-Then syntax

03Strict section-based file structure for organized large-scale test suites

04ADR-Ready scoring system to measure requirement maturity and testability

05Threshold registry integration to eliminate hardcoded values in scenarios

061 GitHub stars

ユースケース

01Translating PRD features into executable acceptance criteria and functional tests

02Validating EARS-formatted requirements with comprehensive behavioral scenarios

03Preparing architectural foundations by defining measurable quality attributes and performance benchmarks

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add vladm3105/aidoc-flow-framework doc-bdd

For use in Claude.ai and ChatGPT

Download Skill