write-bdd

Writes grounded BDD scenarios with Given/When/Then, failure notes, and condition matrices.

Updated Sep 4, 2026
One-click install
npx skills add https://github.com/nakamori-naoya/bdd-discovery-and-formulation-plugins --skill write-bdd-nakamori-naoya
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: write-bdd
Source: https://github.com/nakamori-naoya/bdd-discovery-and-formulation-plugins/tree/main/plugins/bdd-discovery-and-formulation/internal/write-bdd
Command: npx skills add https://github.com/nakamori-naoya/bdd-discovery-and-formulation-plugins --skill write-bdd-nakamori-naoya

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Business rules are often described inconsistently across stakeholders, and BDD scenarios get written from assumptions or implementation details rather than verified facts. This Skill enforces a shared discipline for writing BDD only from grounded inputs—user statements, explicit documents, and decisions confirmed through structured dialogue—so every scenario is traceable to a source. ## Core Features & Use Cases - Grounded Input Discipline: Distinguishes confirmed facts, hypotheses, and unresolved questions, and forbids filling gaps with general knowledge or plausible examples. - Business-Language BDD: Writes scenarios in ubiquitous language with explicit Given/When/Then, mandatory NOTE blocks (Rule/Source/Reason) for failure cases, and a JSON condition matrix validated before content is saved. - Formulation Readiness & QA Falsification: Judges whether existing understanding is ready for formulation, then applies QA perspectives (boundaries, concurrency, permissions, time, failure guarantees) to refute claims. - Use Case: When a discovery or formulation entry point needs to document a reservation cancellation rule, this Skill ensures each scenario lists all preconditions, ties rejections to a specific business rule, and routes open questions through the grill contract before writing via write-doc. ## Quick Start Apply the write-bdd discipline to turn the confirmed reservation cancellation decisions into BDD scenarios with a condition matrix and failure notes.

Frequently Asked Questions about write-bdd

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

FAQPage Schema
How do I write BDD scenarios from business requirements?▼

Ground every scenario in user statements, explicit documents, or confirmed decisions, then write Given with all necessary preconditions, When with a single business action, and Then with observable results. Failure scenarios require a NOTE block citing the business rule and reason.

What is a condition matrix in BDD scenario writing?▼

A condition matrix is a JSON structure listing each scenario's premises, their satisfied or unsatisfied state, the verification target, and input sources. It is validated by an inspection tool before scenarios are written into documents, ensuring preconditions are explicit.

When is existing documentation ready for BDD formulation?▼

Documentation is ready when stakeholders can explain representative success, alternative, and rejection flows in business language covering actors, prior state, events, judgments, and outcomes. If core understanding is missing, return to discovery instead of formulating.

Can I fill gaps in BDD scenarios with reasonable assumptions?▼

No. Ungrounded candidates must be marked explicitly as hypotheses with their basis noted, and unresolved questions recorded with an answer owner. General knowledge or plausible examples are never treated as business facts.

Does this Skill produce documents on its own?▼

No. It is a shared discipline applied inside entry points like discover-domain or formulate-data-model. It produces no artifacts alone and stops if no applying entry point or bundled skill exists.