Why should I reference aggregates by ID instead of object?

Referencing by ID reduces coupling between aggregates, prevents 'God Aggregates' from loading unnecessary data, and makes the system easier to scale or distribute across different databases.

How does this skill identify cross-aggregate transactions?

It scans your Use Cases and Services for multiple repository save calls or manual transaction management affecting different aggregate roots within a single execution scope.

Does this skill support common PHP frameworks?

Yes, it is designed to recognize common PHP patterns and ORM behaviors (like Doctrine or Eloquent) that often lead to architectural violations in DDD environments.

What is a DDD aggregate consistency audit?

It is a process of checking if your domain model follows Domain-Driven Design rules, specifically ensuring that an aggregate root manages all internal state and remains the only entry point for modifications.

DDD Aggregate Consistency Audit

Name: DDD Aggregate Consistency Audit
Author: dykyi-roman

bydykyi-roman

•

Desarrollo de API

Audits PHP code for Domain-Driven Design (DDD) aggregate compliance to ensure transactional consistency and robust domain boundaries.

This skill automates the review of DDD aggregate patterns in PHP applications, ensuring that business logic remains encapsulated within aggregate roots. It identifies critical architectural flaws such as cross-aggregate transactions, improper entity access, and leaked invariants, helping developers maintain clean architecture, high data integrity, and scalable domain models. By analyzing grep patterns and code structures, it provides actionable feedback to fix violations of identity-based referencing and 'God Object' anti-patterns.

Características Principales

01Identifies direct access to child entities bypassing aggregate roots.

02Analyzes aggregate size to prevent 'God Object' anti-patterns.

03Detects cross-aggregate transaction violations to ensure atomicity.

0445 GitHub stars

05Enforces identity-based referencing between aggregates to reduce coupling.

06Flags business invariants implemented outside of domain models.

Casos de Uso

01Onboarding new developers to ensure DDD best practices are followed.

02Performing automated architectural reviews during code refactoring.

03Auditing legacy PHP projects transitioning to Hexagonal or Clean Architecture.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add dykyi-roman/awesome-claude-code check-aggregate-consistency

For use in Claude.ai and ChatGPT

Download Skill