DDD Validate

DDD Validate is a specialized tool designed to help developers maintain the integrity of domain boundaries within a Domain-Driven Design (DDD) codebase. It systematically scans your project to identify cross-context import violations, ensuring that each bounded context remains isolated and adheres to established architectural principles. This is particularly useful when auditing codebases for leaks between contexts, merging changes that affect multiple areas, or implementing continuous integration practices to catch boundary erosion early.

The skill operates by first discovering all bounded contexts within your project, specifically looking in the src/*/domain/ directories. It then checks for direct import statements that violate the boundaries set by DDD principles, such as importing entities directly from another context's domain directory, which is not allowed. Instead, it permits imports only from the public application layer, helping to enforce a clean separation of concerns.

In addition to checking for import violations, DDD Validate also examines aggregate root entities for compliance with invariant enforcement. It flags any public setters that bypass validation and ensures that child entities cannot be accessed directly, thereby maintaining the integrity of the aggregate. Furthermore, it verifies event naming conventions, repository patterns, and outputs a comprehensive report of any violations found, categorized by type and severity. This structured reporting aids developers in quickly addressing issues and improving the overall quality of their codebase.

Whether you are a developer working on a large-scale DDD project or a team lead overseeing multiple contexts, DDD Validate provides the necessary checks to ensure your architecture remains robust and maintainable. By integrating this tool into your CI pipeline, you can catch potential issues early and streamline your development process, ensuring that your code adheres to the principles of Domain-Driven Design.