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

0•

Developer Tools

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

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

010 GitHub stars

02Port-Adapter Verification: Validates that domain logic remains isolated from external infrastructure through proper interface definitions.

03Ubiquitous Language Validation: Cross-references documentation with code to ensure consistent terminology.

04Aggregate Boundary Checking: Ensures cross-aggregate references use identifiers rather than direct object instances.

05Layered Architecture Enforcement: Detects illegal dependencies between API, Application, Domain, and Infrastructure layers.

06Entity and Value Object Auditing: Verifies identity logic, immutability rules, and proper use of decorators like frozen=True.

Use Cases

01Performing automated architectural reviews to ensure new features follow established DDD patterns.

02Refactoring legacy code into a clean, layered architecture by identifying and fixing dependency violations.

03Maintaining consistency between domain documentation (AIDLC) and backend implementation during rapid iterations.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add foie0222/baken-kaigi ddd-check

For use in Claude.ai and ChatGPT

Download Skill