bdd-practices

Generate Gherkin .feature files from software requirements for BDD workflows.

9|Updated Jan 31, 2017
One-click install
npx skills add https://github.com/ssiumha/dots --skill bdd-practices
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bdd-practices
Source: https://github.com/ssiumha/dots/tree/main/prompts/skills/bdd-practices
Command: npx skills add https://github.com/ssiumha/dots --skill bdd-practices

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

BDD Practices translates requirements into Gherkin-style .feature files, enabling living documentation and optional automation.

Core Features & Use Cases

  • Phase-based discovery, formulation, and optional automation
  • Living documentation via .feature as executable or review-only
  • Examples: login flow, CRUD workflows, and generic feature templates

Quick Start

Request "bdd" or "명세" to generate .feature files and map to automation steps; optionally connect to tdd-practices for step definitions.

Frequently Asked Questions about bdd-practices

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

FAQPage Schema
How do I write Gherkin specifications for software features?

Gherkin is a plain-language syntax for writing .feature files that describe software behavior. BDD practices use Gherkin's Given-When-Then structure to translate requirements into executable scenarios, enabling living documentation and shared understanding between technical and non-technical stakeholders.

Can I automate Gherkin scenarios with Python or JavaScript?

Yes. Gherkin .feature files can be linked to test automation using Python or JavaScript frameworks. BDD practices support optional automation that connects scenario steps to code, turning specifications into executable tests while maintaining readable documentation.

What's the difference between BDD and traditional test-driven development?

BDD extends TDD by starting with human-readable scenarios written in Gherkin before code. Where TDD writes tests in code, BDD clarifies requirements through feature files first, then optionally automates them. This keeps specifications, tests, and documentation aligned throughout development.

How do I create living documentation from feature files?

Gherkin .feature files serve as living documentation that stays current with code. BDD practices guide discovery and formulation phases to produce executable or review-only specifications. Feature files act as both requirements and runnable tests, reducing documentation drift.

When should I use BDD for CRUD workflows and login flows?

BDD works well for scenarios with clear user interactions and expected outcomes. Login flows and CRUD operations are concrete enough to express in Given-When-Then format. BDD practices provide templates and phase-driven guidance to extract these scenarios from requirements consistently.

What are the limitations of Gherkin-based specifications?

Gherkin excels at user-facing workflows but can become verbose for complex business logic or data-heavy operations. BDD practices include red-flag guidance to prevent anti-patterns—over-automation of non-BDD logic or scenarios too technical for stakeholder review reduce the value of living documentation.