discover-domain

Discovers core domain business rules and produces a BDD-based domain-rule document.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Business rules are often described inconsistently across stakeholders, with boundary conditions and permissions left undefined. This Skill turns fragmented business knowledge into a single authoritative domain-rule document containing representative BDD scenarios, so business people and developers share the same understanding before implementation or QA begins. ## Core Features & Use Cases - Structured discovery workflow: Follows a playbook of settle, ground, explore, scope, record-behavior, validate, and document steps, using the grill plugin to ask only skeleton-defining questions. - Business vs. implementation boundary: Separates durable business rules from UI, API, data model, and operational concerns, recording excluded items with reasons. - Deterministic validation scripts: Checks the BDD condition matrix structure and verifies that the commands/queries table matches the actor-permission table before saving. - Use Case: Given only the phrase "reservations can be cancelled," the Skill explores who can cancel, in which states, under what conditions acceptance or rejection occurs, and saves a domain-rule document with representative Given/When/Then scenarios. ## Quick Start Ask the agent to discover the core domain rules for reservation cancellation from the existing glossary and requirements documents and produce a domain-rule document with representative BDD scenarios.

Frequently Asked Questions about discover-domain

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

FAQPage Schema
How do I document business rules with BDD scenarios?▼

Use this Skill to explore business events, actors, and judgments from your existing materials, then it produces a domain-rule document with representative Given/When/Then scenarios. It validates the condition matrix and actor coverage before saving the document.

What is the difference between discovery and formulation in BDD?▼

Discovery creates a new shared understanding and authoritative document from unknown business knowledge, even when related materials exist. Formulation refutes an existing authoritative document with boundary cases and writes results back to the same path.

Does this Skill require external plugins to run?▼

Yes, it requires the grill plugin for structured stakeholder questioning and the write-doc plugin for saving the domain-rule document. Internal skills like write-bdd and explore-events are bundled in the same package.

When should I not use domain discovery?▼

Do not use it when you only need to refute an existing domain-rule document with boundary values or concurrency cases; that is formulation's role. It also excludes UI flows, API contracts, data models, and operational concerns, which belong to other documents.

How does the Skill handle uncertain or missing business facts?▼

It never invents facts; uncertain items are recorded as explicit hypotheses with rationale and unchosen interpretations in an open questions section. Only user statements, provided documents, and confirmed decisions are treated as business facts.