skills.rest
vladm3105
vladm3105COMMUNITY
Explore all skills by this author →
GitHub

doc-bdd-validator

Validate BDD documents against Layer 4 schema standards for Gherkin syntax and traceability.

16|3|Updated Nov 10, 2025
Search Tags:#validation#traceability#BDD#Gherkin
One-click install
npx skills add https://github.com/vladm3105/aidoc-flow-framework --skill doc-bdd-validator
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: doc-bdd-validator
Source: https://github.com/vladm3105/aidoc-flow-framework/tree/main/.claude/skills/doc-bdd-validator
Command: npx skills add https://github.com/vladm3105/aidoc-flow-framework --skill doc-bdd-validator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill validates Behavior-Driven Development (BDD) documents against Layer 4 schema standards to ensure proper Gherkin syntax, traceability, and scenario coverage.

Core Features & Use Cases

  • Validate Gherkin syntax and scenario structure
  • Ensure traceability to BRD/PRD/EARS
  • Produce ADR/SYS/REQ traceability results

Quick Start

Validate a BDD file to confirm proper feature, scenarios, and traceability.

Frequently Asked Questions about doc-bdd-validator

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

FAQPage Schema
How do I validate Gherkin syntax and BDD document structure?▼

Gherkin syntax validation checks feature files for proper formatting, scenario structure, and required sections. This Skill applies Layer 4 schema standards to verify features, scenarios, backgrounds, and outlines conform to BDD conventions, catching syntax errors before execution.

What does traceability validation in BDD documents mean?▼

Traceability validation ensures BDD scenarios link to upstream requirements through BRD, PRD, or EARS documentation via metadata tags. This Skill verifies traceability tags are present, correctly formatted, and map scenarios to their source requirements.

How do I check if BDD documents are ADR-ready?▼

ADR-ready scoring evaluates whether BDD artifacts meet Architecture Decision Record standards for metadata completeness, required sections, and proper Gherkin syntax. This Skill produces a readiness score indicating gaps before formal ADR submission.

Can I validate BDD file naming conventions and metadata fields?▼

Yes. This Skill validates file naming conventions, custom metadata fields, and required tags against Layer 4 schema standards. It reports detailed error codes for any naming or metadata violations.

What validation errors does this Skill report?▼

The Skill reports detailed error codes covering metadata validation failures, structural violations across sections 1-9, Gherkin syntax errors, missing traceability tags, and ADR readiness gaps with specific line references.

Related Skills

Explore More Software Engineering Skills→
FoxSilouFoxSilou

task-bdd-workshop

Generate example maps and Gherkin scenarios from event-storming markdown files.

Community
Basic
vladm3105vladm3105
16

test-automation

Generate executable test suites from SDD artifacts across multiple frameworks.

Community
Advanced
vladm3105vladm3105
16

doc-bdd

Generate Layer-4 BDD test scenarios in Gherkin Given-When-Then format.

Community
Advanced
tsuji-tomonoritsuji-tomonori

doc-rq-rtm

Generate and update diopside Requirement Traceability Matrix documents for Quartz publication.

Community
Intermediate