bdd-scenarios

Standardize Gherkin BDD scenario creation and review against 24 axioms.

3|Updated Dec 14, 2025
One-click install
npx skills add https://github.com/plocher/jBOM --skill bdd-scenarios-plocher
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bdd-scenarios
Source: https://github.com/plocher/jBOM/tree/main/.agents/skills/bdd-scenarios
Command: npx skills add https://github.com/plocher/jBOM --skill bdd-scenarios-plocher

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill addresses the inconsistency and ambiguity often found in BDD test suites by enforcing a strict set of 24 axioms that ensure scenarios are deterministic, maintainable, and aligned with the jBOM architecture.

Core Features & Use Cases

  • Axiom Enforcement: Provides a comprehensive checklist and guidance for writing Gherkin scenarios that avoid common anti-patterns like hardcoded values or implicit context.
  • Structural Standardization: Ensures consistent use of the three-tier test data builder pattern and proper hierarchy between KiCad projects, schematics, and components.
  • Use Case: Use this skill when reviewing a new pull request to verify that the proposed BDD scenarios correctly exercise the CLI surface and follow the project's strict behavioral testing standards.

Quick Start

Use the bdd-scenarios skill to audit the current feature file against the 24 BDD axioms and provide a report on any violations.

Frequently Asked Questions about bdd-scenarios

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

FAQPage Schema
How do I validate Gherkin BDD scenarios against standard testing axioms?

To validate Gherkin BDD scenarios, audit feature files against the 24 defined BDD axioms to identify violations like hardcoded values or implicit context. This standardization ensures scenarios are deterministic, maintainable, and correctly exercise CLI and service API layers.

What is the best way to standardize BDD test scenarios for KiCad project hierarchies?

Standardizing BDD test scenarios for KiCad project hierarchies involves applying a three-tier test data builder pattern. This enforces proper structural hierarchy between projects, schematics, and components, ensuring strict adherence to behavioral testing standards.

How do I review a pull request for BDD regression test suites?

Review a pull request for BDD regression test suites by auditing the proposed feature file against the 24 BDD axioms. This verifies that scenarios correctly exercise the CLI surface and follow strict behavioral testing standards.

Why does my BDD scenario fail the axiom check for explicit preconditions?

BDD scenarios fail axiom checks for explicit preconditions when they contain anti-patterns like implicit context or hardcoded values. Enforcing strict adherence to the 24 BDD axioms ensures scenarios avoid these issues and remain deterministic.

Can I use Gherkin scenarios to test both CLI and service API layers?

Yes, you can use Gherkin scenarios to test both CLI and service API layers. The standardization process applies to the development and maintenance of regression test suites that specifically exercise both the CLI and service API surfaces.