Can it detect violations of specific design patterns?

Yes, it specifically checks for SOLID, DRY, YAGNI, and Separation of Concerns (SoC) patterns to ensure your code follows established engineering best practices.

How does this skill help with code maintainability?

It identifies high-level structural issues like tight coupling and violations of core design principles that typically lead to technical debt and difficult maintenance.

Does it flag every instance of code duplication?

No, it intelligently ignores intentional duplication that is documented for clarity, focusing instead on problematic violations that hinder scalability.

Which files does the architecture agent prioritize?

The skill focuses on critical business logic files, services, factories, handlers, and files exceeding 500 lines where architectural drift is most common.

Architecture Principles Review

Name: Architecture Principles Review
Author: JesseNaranjo

byJesseNaranjo

•

Collaboration Tools

Audits codebases for architectural integrity by identifying violations of SOLID, DRY, YAGNI, and Separation of Concerns principles.

This skill enhances Claude's code review capabilities by focusing specifically on high-level architectural health and structural quality. It systematically scans for coupling issues, anti-patterns, and layer violations, particularly within complex service layers and large, logic-heavy files. By leveraging scope prioritization for critical business components like Factories and Managers, it ensures that maintainability and scalability are prioritized during the development lifecycle while intelligently accounting for intentional, documented pragmatic compromises.

Key Features

01Identifies architectural anti-patterns and improper coupling

02Evaluates file organization and layer integrity for better project structure

03Detects violations of SOLID, DRY, YAGNI, and SoC principles

04Prioritizes analysis of large files and core business logic components

051 GitHub stars

06Recognizes documented architectural compromises to minimize false positives

Use Cases

01Enforcing design pattern consistency across distributed service layers

02Performing deep architectural audits on legacy codebases or complex pull requests

03Identifying refactoring opportunities in bloated or highly coupled software modules

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jessenaranjo/ai-setup reviewing-architecture-principles

For use in Claude.ai and ChatGPT

Download Skill