domain-modeling

Translate user stories into a formal domain model with entities, value objects, and state machines.

1|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/slusset/intention-driven-design --skill domain-modeling-slusset
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: domain-modeling
Source: https://github.com/slusset/intention-driven-design/tree/main/skills/domain-modeling
Command: npx skills add https://github.com/slusset/intention-driven-design --skill domain-modeling-slusset

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Capture the essential business concepts and rules that emerge from user stories and translate them into a formal domain model to anchor both contracts and implementation.

Core Features & Use Cases

  • Identify entities, value objects, and aggregates from stories
  • Define entity lifecycles (state machines) and invariants
  • Output domain definitions to specs/models for downstream contracts and implementations

Quick Start

Create a formal domain model by extracting concepts from specs/stories and drafting model artifacts that reference the relevant stories.

Frequently Asked Questions about domain-modeling

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

FAQPage Schema
How do I translate user stories into a formal domain model?

To translate user stories into a formal domain model, extract business concepts to identify entities, value objects, and aggregates, then define their lifecycles and invariants to anchor contracts and implementation.

What is the best way to define entity lifecycles and invariants from specs?

Defining entity lifecycles and invariants from specs involves drafting model artifacts that reference relevant stories, satisfying schemas for state machines and entity definitions with traceability to the original requirements.

When do I need to identify aggregates and value objects for my software architecture?

You need to identify aggregates and value objects when clarifying domain boundaries across specs and models, ensuring that formal business concepts and rules are captured to guide downstream contracts and implementation.

How do I extract domain entities and state machines from user stories?

Extracting domain entities and state machines from user stories requires analyzing the text to capture essential business concepts, then mapping those concepts into formal schemas that define state transitions and invariants.

Can I use domain modeling to guide contracts and implementation across boundaries?

Yes, domain modeling guides contracts and implementation across boundaries by outputting formal domain definitions to specs/models, ensuring that downstream development aligns with the established business rules and lifecycle constraints.

Does formal domain modeling require existing specs and models to work?

Formal domain modeling requires existing user stories in specs to extract concepts from, and it outputs to specs/models, meaning you need prerequisite requirement documentation to anchor the domain definitions and traceability.