forward-derivation

Derive BDD scenarios and TDD skeletons from approved SDD specifications.

5|1|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/ValorVie/custom-skills --skill forward-derivation-valorvie
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: forward-derivation
Source: https://github.com/ValorVie/custom-skills/tree/main/skills/forward-derivation
Command: npx skills add https://github.com/ValorVie/custom-skills --skill forward-derivation-valorvie

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Derives BDD scenarios and TDD test skeletons from approved SDD specifications, enabling fast, traceable test generation with an explicit 1:1 mapping between acceptance criteria and outputs.

Core Features & Use Cases

  • SPEC Parsing: reads approved specifications, extracts Acceptance Criteria, and validates structure.
  • BDD Derivation: produces Gherkin scenarios from AC for executable acceptance tests.
  • TDD Derivation: creates test skeletons with TODO placeholders aligned to AC.
  • Optional ATDD: can generate optional acceptance test tables if needed.
  • Human Review & Traceability: ensures source attribution and maintains 1:1 AC mapping for each artifact.

Quick Start

Provide an approved SPEC file and run the derivation commands (e.g., /derive-bdd, /derive-tdd, or /derive-all) to generate BDD features and TDD skeletons.

Frequently Asked Questions about forward-derivation

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

FAQPage Schema
How do I generate BDD scenarios from approved software specifications?

To generate BDD scenarios from specifications, you provide an approved SDD spec and run the derivation command, which parses the file to produce Gherkin features with a 1:1 mapping to your acceptance criteria.

Can I automatically create TDD test skeletons from acceptance criteria?

Yes, you can create TDD test skeletons from acceptance criteria by running the derivation command on an approved spec, which generates code skeletons with TODO placeholders directly aligned to each criterion.

What is the best way to ensure traceability between acceptance criteria and generated tests?

The best way to ensure traceability is using forward-derivation, which enforces an explicit 1:1 mapping between every acceptance criterion and its generated BDD scenarios or TDD skeletons, complete with source attribution.

How do I generate ATDD tables alongside BDD features and TDD skeletons?

To generate ATDD tables alongside BDD features and TDD skeletons, you run the full derivation command, which optionally produces acceptance test tables from your approved SDD specifications during the derivation workflow.

Do I need a fully approved SDD specification before deriving Gherkin scenarios?

Yes, you need a fully approved SDD specification before deriving Gherkin scenarios, because the derivation process validates the spec structure and relies on finalized acceptance criteria to maintain accurate source attribution.

What happens if my specification structure is invalid during test generation?

During test generation, if your specification structure is invalid, the SPEC parsing stage will fail to extract the acceptance criteria properly, preventing the derivation of BDD scenarios and TDD skeletons until the spec is corrected.