formulate-domain

Refines existing domain-rule documents by challenging core business rules with QA-driven BDD scenarios.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Existing domain-rule documents often miss boundary conditions, rejection criteria, and actor permissions, leaving business rules ambiguous. This Skill challenges an existing domain-rule document with QA-perspective counterexamples and writes confirmed findings back into the same file, deepening shared business understanding without creating new documents. ## Core Features & Use Cases - QA-driven refutation: Applies structured questioning (via the grill plugin) to challenge existing business rules with boundary values, concurrency, and permission edge cases. - BDD scenario validation: Validates Gherkin drafts against condition matrices using scripts/scenario.py, and checks actor coverage consistency between command/query tables and permission tables. - In-place document update: Guards that the output path matches the existing source document (scripts/update-guard.py) and writes the revised domain-rule back via the write-doc plugin. - Use Case: Given an existing reservation-cancellation domain-rule document, challenge it with scenarios like cancellation exactly at the deadline and double cancellation, then update the same document with confirmed boundary rules and open questions. ## Quick Start Challenge my existing reservation-cancellation domain-rule document with boundary scenarios like the exact deadline and duplicate cancellation, and update the same file with the confirmed findings.

Frequently Asked Questions about formulate-domain

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

FAQPage Schema
How do I deepen an existing domain-rule document with BDD?▼

Provide the absolute path of the existing domain-rule document and your refinement request. The skill challenges the core rules with QA-perspective questions, drafts boundary BDD scenarios, validates them, and writes confirmed findings back to the same file.

What is the difference between discover-domain and formulate-domain?▼

formulate-domain only refutes and updates an existing domain-rule document at the same path; it never creates new documents. Use discover-domain when no authoritative domain-rule document exists yet and you need to create one from exploration.

Does formulate-domain require external plugins?▼

Yes. It requires the grill plugin for structured stakeholder questioning and the write-doc plugin for writing the revised domain-rule document. Both are declared in the playbook's requires section.

Why does formulate-domain stop instead of completing the update?▼

It stops when required inputs are missing or invalid, such as a nonexistent or symlinked source path, relative reference paths, failed validation scripts, or the write-doc plugin returning a non-completed status. It never modifies the existing document when stopping.

Can formulate-domain handle unconfirmed or ambiguous business rules?▼

Yes. Instead of stopping, it records the most plausible interpretation as an explicit hypothesis with its rationale in the document and the open questions section, so unconfirmed points remain visible for later confirmation.