lybtzyzs-design-arch-validator

What problem does it solve?

This Skill prevents costly architectural violations by rigorously validating technical designs against established architectural principles. It ensures that API designs, service responsibilities, and repository usage adhere to DDD aggregate root patterns and Write/Read Layer separation, catching issues before coding begins.

Core Features & Use Cases

• Mandatory Architecture Document Reading: Enforces reading of core architectural guidelines before design generation or validation, ensuring foundational understanding and preventing design flaws.
• API Endpoint Design Validation: Automatically checks if proposed API endpoints conform to Write/Read/Helper layer separation and DDD aggregate root principles (e.g., all write operations for MedicalCase must go through the MedicalCase aggregate root).
• Automated Compliance Check: Integrates and automatically runs lybtzyzs-arch-compliance to provide a comprehensive architectural assessment, requiring zero violations before proceeding to implementation.
• Use Case: After a design document is created, this Skill validates its API endpoints. If it finds a POST /api/v1/consultations/{id}/complete-step1 endpoint, it flags it as a violation because it bypasses the MedicalCase aggregate root for a write operation, suggesting the correct POST /api/v1/medicalcases/{id}/complete-step1.

Quick Start

Validate the architectural compliance of the design document docs/explanation/medicalcase-enhancement-design.md.