domain-design-review

Review domain designs for architectural anti-patterns before implementation.

5|Updated Sep 9, 2017
One-click install
npx skills add https://github.com/hpcsc/dotfiles --skill domain-design-review-hpcsc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: domain-design-review
Source: https://github.com/hpcsc/dotfiles/tree/main/link/common/claude/.claude/skills/domain-design-review
Command: npx skills add https://github.com/hpcsc/dotfiles --skill domain-design-review-hpcsc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Domain designs often embed architectural anti-patterns—god objects, cross-context coupling, wireframe-driven modeling—that only surface as costly problems during implementation. This Skill catches those issues at design time by reviewing aggregates, bounded contexts, and event flows against a structured checklist. ## Core Features & Use Cases - Anti-Pattern Detection: Identifies wireframe-driven design, noun-based modeling, context violations, blurred boundaries, and data coupling. - Design Checklist: Verifies events are identified before commands, bounded contexts are clear, and aggregates represent true consistency boundaries. - Auto-Triggering: Activates when designing new features, aggregates, or bounded contexts. - Use Case: Before implementing a new order management feature, run a design review to confirm the Order aggregate changes for one category of reasons and communicates with Inventory through events rather than direct service calls. ## Quick Start Ask the AI to review your proposed domain design for a new feature or aggregate against common architectural anti-patterns.

Frequently Asked Questions about domain-design-review

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

FAQPage Schema
How do I review a domain design for anti-patterns?▼

Check that domain events are identified before commands, bounded context boundaries are clear, and each aggregate changes for only one category of reasons. Flag god objects handling 10 or more event types and any direct service-to-service calls across contexts.

What are common domain-driven design anti-patterns?▼

Common anti-patterns include wireframe-driven design starting from UI mockups, noun-based modeling where aggregates change for multiple unrelated reasons, context violations via direct cross-service calls, blurred boundaries from shared structs, and data coupling through cross-context database joins.

When should a domain design review happen?▼

Run the review before implementation, when designing new features, aggregates, or bounded contexts. Catching anti-patterns at design time is far cheaper than refactoring coupled services and shared database tables after code ships.

What is a god object in domain modeling?▼

A god object is an aggregate that handles too many responsibilities, typically signaled by processing 10 or more event types. It indicates the aggregate changes for multiple unrelated reasons and should be split along true consistency boundaries.

Why avoid sharing database tables across bounded contexts?▼

Cross-context database joins create data coupling that breaks context autonomy and makes independent deployment impossible. Each context should own its data and communicate through events rather than direct queries into another context's storage.