Skip to content

[Extension] spec-kit-bdd #3546

Description

@RSginer

Extension ID

bdd

Extension Name

Spec-Kit BDD

Version

1.0.2

Description

ATDD/BDD extension: convert specs to Gherkin scenarios, scaffold step definitions, and verify acceptance test coverage.

Author

Rubén Soler

Repository URL

https://github.com/RSginer/spec-kit-bdd

Download URL

https://github.com/RSginer/spec-kit-bdd/archive/refs/tags/v1.0.2.zip

License

MIT

Homepage (optional)

https://github.com/RSginer/spec-kit-bdd

Documentation URL (optional)

https://github.com/RSginer/spec-kit-bdd/blob/main/docs/usage.md

Changelog URL (optional)

https://github.com/RSginer/spec-kit-bdd/releases

Required Spec Kit Version

=0.2.0

Required Tools (optional)

Optional: pytest-bdd or behave (Python), @cucumber/cucumber (JavaScript/TypeScript), cucumber (Ruby), io.cucumber (Java), or SpecFlow (C#) - depending on chosen step-definition language

Number of Commands

3

Number of Hooks (optional)

2

Tags

bdd, gherkin, atdd, acceptance-testing, tdd

Key Features

  • /speckit.bdd.scenarios - generates Gherkin .feature files from a spec-kit specification
  • /speckit.bdd.scaffold - generates step definition stubs (Python, JavaScript, Ruby, Java, C#) ready to implement
  • /speckit.bdd.verify - produces a traceability matrix mapping spec requirements to scenarios
  • Optional after_specify hook - prompts to generate scenarios right after writing a spec
  • Optional before_implement hook - prompts to scaffold step stubs before implementation starts
  • Supports pytest-bdd, behave, @cucumber/cucumber, cucumber (Ruby), io.cucumber (Java), and SpecFlow (C#)

Testing Checklist

  • Extension installs successfully via download URL
  • All commands execute without errors
  • Documentation is complete and accurate
  • No security vulnerabilities identified
  • Tested on at least one real project

Submission Requirements

  • Valid extension.yml manifest included
  • README.md with installation and usage instructions
  • LICENSE file included
  • GitHub release created with version tag
  • All command files exist and are properly formatted
  • Extension ID follows naming conventions (lowercase-with-hyphens)

Testing Details

Tested on

  • MacOS Tahoe 26.5.1 Pro, Spec-kit v0.5.2.dev0

Example Usage

# Install extension
specify extension add bdd --from https://github.com/RSginer/spec-kit-bdd/archive/refs/tags/v1.0.2.zip

# Generate Gherkin scenarios from a spec
/speckit.bdd.scenarios

# Scaffold step definitions before implementing
/speckit.bdd.scaffold

# Verify spec-to-scenario coverage
/speckit.bdd.verify

Proposed Catalog Entry

{
  "bdd": {
    "name": "Spec-Kit BDD",
    "id": "bdd",
    "description": "ATDD/BDD extension: convert specs to Gherkin scenarios, scaffold step definitions, and verify acceptance test coverage.",
    "author": "RSginer",
    "version": "1.0.2",
    "download_url": "https://github.com/RSginer/spec-kit-bdd/archive/refs/tags/v1.0.2.zip",
    "repository": "https://github.com/RSginer/spec-kit-bdd",
    "homepage": "https://github.com/RSginer/spec-kit-bdd",
    "license": "MIT",
    "requires": {
      "speckit_version": ">=0.2.0"
    },
    "provides": {
      "commands": 3,
      "hooks": 2
    },
    "tags": ["bdd", "gherkin", "atdd", "acceptance-testing", "tdd"],
    "verified": false,
    "downloads": 0,
    "stars": 0,
    "created_at": "2026-07-15T00:00:00Z",
    "updated_at": "2026-07-15T00:00:00Z"
  }
}

Additional Context

Image

Metadata

Metadata

Assignees

Type

No type

Fields

No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions