Formulation Skill

Formalize ambiguous requirements into executable BDD acceptance criteria and Gherkin outputs.

Updated Nov 8, 2025
One-click install
npx skills add https://github.com/yodakeisuke/BDD-promps-with-eval --skill formulation-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Formulation Skill
Source: https://github.com/yodakeisuke/BDD-promps-with-eval/tree/main/.claude/skills/bdd/formulation
Command: npx skills add https://github.com/yodakeisuke/BDD-promps-with-eval --skill formulation-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

このスキルは、Example Mappingで明確化されたビジネスルールと具体例を、開発・テスト自動化に直接利用できるGherkin形式の仕様書に変換する手間を省きます。手動でのGherkin記述ミスやフォーマットの不統一を防ぎ、Living Documentationの維持を容易にします。

Core Features & Use Cases

  • Gherkin形式変換: Example Mappingの成果物からFeature、Rule、Example(Given-When-Then)を自動生成し、一貫性のある仕様書を作成します。
  • 品質チェック: ビジネス観点と技術観点からGherkin仕様の品質を検証し、実行可能性と理解しやすさを保証します。
  • テスト自動化基盤: Example Mappingセッション後に、開発チームが自動テストの基盤となるGherkinファイルを迅速に作成し、テスト駆動開発(TDD)や振る舞い駆動開発(BDD)のサイクルを加速する際に活用します。

Quick Start

Formulationスキルを使って、以下のExample Mappingの成果物をGherkin仕様に変換してください: Rule: キーワードに部分一致する商品を表示 Example: 入力: "MacBook Pro" → 結果: "MacBook Pro" が表示される

Frequently Asked Questions about Formulation Skill

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

FAQPage Schema
How do I convert Example Mapping outputs into executable Gherkin specifications?

Formulation transforms Example Mapping artifacts—business rules and concrete examples—into structured Gherkin format. It automatically generates Feature files, Rules, and Given-When-Then scenarios, ensuring consistency and eliminating manual formatting errors while maintaining living documentation.

What is BDD and how does it improve test automation?

Behavior-driven development (BDD) uses Gherkin syntax to write executable acceptance criteria in business language, bridging stakeholders and developers. It accelerates test-driven development cycles by generating automated test foundations directly from formalized requirements.

Can I automate quality checks on my Gherkin specifications?

Yes. Formulation validates Gherkin specifications from both business and technical perspectives, verifying executability and readability. This prevents ambiguity and ensures your specifications remain maintainable and aligned with automation frameworks.

How do I prevent inconsistencies when writing Gherkin acceptance criteria?

Formulation generates Gherkin automatically from Example Mapping sessions, eliminating manual writing errors and format inconsistency. Structured artifact generation—story cards, rule cards, and example cards—ensures uniform acceptance criteria across your test suite.

What's the best way to implement living documentation with Cucumber?

Formulation maintains living documentation by automatically generating executable Gherkin files from business rules and examples, keeping specifications synchronized with code. Continuous artifact generation prevents documentation drift as requirements evolve.

Do I need Active Listening and Example Mapping before using Formulation?

Yes. Formulation requires structured stakeholder input—business rules, examples, and scope extracted through Active Listening and Example Mapping sessions. These preparatory techniques ensure requirements are unambiguous and ready for Gherkin conversion.