What happens if a document fails validation?

The skill generates a detailed Validation Report listing specific error codes (like BDD-E010 for syntax errors) and warnings (like BDD-W002 for missing tags) to help the user fix the issues.

How does it handle traceability?

The skill checks for specific cumulative tags like @brd, @prd, and @ears to ensure every BDD scenario is mapped back to its parent business and product requirements.

Can I validate standard .feature files with this skill?

Yes, the validator supports both specialized Markdown-based BDD documents and standard Gherkin .feature files typically used in testing frameworks.

What is the purpose of the doc-bdd-validator skill?

It is designed to validate BDD documentation against specific structural and content standards, ensuring they are complete, correctly formatted in Gherkin, and properly linked to upstream requirements.

What does the ADR-Ready score represent?

The ADR-Ready score is a quality metric (threshold 90%) that evaluates scenario coverage, step clarity, data completeness, and traceability to determine if a BDD document is ready for architectural review.

BDD Document Validator

Name: BDD Document Validator
Author: vladm3105

byvladm3105

•

学習とドキュメンテーション

Validates Behavior-Driven Development (BDD) documents against Layer 4 schema standards to ensure structural integrity and Gherkin syntax compliance.

The BDD Document Validator is a specialized skill designed to enforce quality and consistency across Behavior-Driven Development artifacts within the AI Doc Flow Framework. It automatically checks BDD documents for mandatory metadata, specific document structures (including Document Control and Traceability sections), and correct Gherkin syntax. By calculating an 'ADR-Ready' score based on scenario coverage and data completeness, it ensures that requirements are mature enough for downstream architectural decisions and test implementations. This skill is essential for teams maintaining high-compliance documentation where traceability between business rules and technical scenarios is critical.

主な機能

01Detailed validation reporting with categorized error and warning codes

021 GitHub stars

03Mandatory metadata and tag taxonomy verification for Layer 4 artifacts

04ADR-Ready quality scoring to benchmark document maturity

05Automated traceability checking for @brd, @prd, and @ears references

06Comprehensive Gherkin syntax and GWT (Given-When-Then) structure validation

ユースケース

01Ensuring BDD documents meet organizational standards before merging into a shared repository

02Maintaining rigorous traceability between upstream business requirements and technical BDD artifacts

03Validating Gherkin scenarios for consistency before they are consumed by automated testing tools

What are Skills?·How to Install

Install with 🐟 Skill.Fish

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

For use in Claude.ai and ChatGPT

Download Skill