Does it provide suggestions for fixing violations?

Absolutely. When a violation is detected, the skill outputs a detailed report including the file location, the reason for the violation, and a recommended code snippet for the fix.

What kind of architectural violations can it detect?

It detects improper layer dependencies (e.g., domain layer importing infrastructure), mutable value objects, missing identifiers in entities, and direct object references between different aggregates.

How does ddd-check verify ubiquitous language?

It parses the ubiquitous_language.md file within your AIDLC documentation and uses grep/regex to ensure defined English terms are correctly used as class names and variables in your domain layer.

Can I target specific directories for validation?

Yes, the skill supports specific flags like --domain-only to focus on the core business logic or --file to audit a specific entity or service.

DDD Design Principle Checker

Name: DDD Design Principle Checker
Author: foie0222

byfoie0222

Developer Tools

Validates code implementation against Domain-Driven Design (DDD) principles and project documentation to ensure architectural integrity.

About

The DDD Design Principle Checker is a specialized utility for Claude Code designed to enforce Domain-Driven Design standards throughout the development lifecycle. It automatically verifies the consistency between AI-Driven Life Cycle (AIDLC) documentation and the actual implementation, ensuring that ubiquitous language is maintained across layers. By auditing entity structures, value object immutability, aggregate boundaries, and the port-adapter pattern, this skill helps developers detect architectural drift early and maintain a clean, decoupled domain model that aligns perfectly with business requirements.

Key Features

0 GitHub stars
Port-Adapter Verification: Validates that domain logic remains isolated from external infrastructure through proper interface definitions.
Ubiquitous Language Validation: Cross-references documentation with code to ensure consistent terminology.
Aggregate Boundary Checking: Ensures cross-aggregate references use identifiers rather than direct object instances.
Layered Architecture Enforcement: Detects illegal dependencies between API, Application, Domain, and Infrastructure layers.
Entity and Value Object Auditing: Verifies identity logic, immutability rules, and proper use of decorators like frozen=True.

Use Cases

Performing automated architectural reviews to ensure new features follow established DDD patterns.
Refactoring legacy code into a clean, layered architecture by identifying and fixing dependency violations.
Maintaining consistency between domain documentation (AIDLC) and backend implementation during rapid iterations.

About

Key Features

0 GitHub stars
Port-Adapter Verification: Validates that domain logic remains isolated from external infrastructure through proper interface definitions.
Ubiquitous Language Validation: Cross-references documentation with code to ensure consistent terminology.
Aggregate Boundary Checking: Ensures cross-aggregate references use identifiers rather than direct object instances.
Layered Architecture Enforcement: Detects illegal dependencies between API, Application, Domain, and Infrastructure layers.
Entity and Value Object Auditing: Verifies identity logic, immutability rules, and proper use of decorators like frozen=True.

Use Cases

Performing automated architectural reviews to ensure new features follow established DDD patterns.
Refactoring legacy code into a clean, layered architecture by identifying and fixing dependency violations.
Maintaining consistency between domain documentation (AIDLC) and backend implementation during rapid iterations.