domain-modeling
Model core domain concepts for the widget host app: entities, value objects, aggregates, invariants, and domain services. Use when defining the domain layer, enforcing rules, or refactoring business logic out of UI/application layers.
📖 中文导读:Model core domain concepts for the widget host app: entities, value objects, aggregates, invariants, and domain services. Use when defining the domain layer, enforcing rules, or refactoring business logic out of UI/application layers. 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: domain-modeling description: Model core domain concepts for the widget host app: entities, value objects, aggregates, invariants, and domain services. Use when defining the domain layer, enforcing rules, or refactoring business logic out of UI/application layers.
Domain Modeling
Overview
Define stable domain concepts and invariants so business rules live outside the UI and infrastructure.
Core concepts
- Entities: identity-based objects with lifecycle.
- Value objects: immutable, equality by value.
- Aggregates: consistency boundaries for changes.
- Domain services: behavior that does not belong to a single entity/value object.
Definition of done (DoD)
- Value objects are immutable (no public setters)
- Entities validate invariants in constructors/factory methods
- Domain has no dependencies on Infrastructure or UI
- Invalid state is rejected at creation, not deferred to save
- Domain types have corresponding unit tests for invariants
Invariants
- Keep invariants inside the aggregate root.
- Enforce invariants via constructors/factory methods.
- Reject invalid state early; do not rely on UI validation alone.
Workflow
- Identify domain nouns/verbs (widgets, layouts, schedules).
- Choose entity vs value object and define invariants.
- Group related entities into aggregates.
- Extract domain services for cross-entity behavior.
- Keep domain types persistence-agnostic.
Examples
Use value objects for identities, sizes, positions, and schedule settings to keep behavior consistent.
References
references/entities-and-values.mdfor modeling guidelines.references/aggregates.mdfor aggregate boundaries.references/invariants.mdfor rule enforcement patterns.