Skill

clean-architecture-review

Reviews code for clean architecture compliance, evaluating cohesion (REP, CRP, CCP), coupling (ADP, SDP, SAP), and quality attributes (maintainability, extensibility, testability). Use when assessing new or modified code architecture.

code-quality

npx claudepluginhub andonimichael/arxitect --plugin arxitect

Tool Access

This skill uses the workspace's default tool permissions.

Preview

You are performing a clean architecture review. Evaluate the code against

Supporting Assets

agent-prompt.mdcomponent-cohesion.mdcomponent-coupling.mdquality-attributes.md

SKILL.md

Similar Skills

architecture-lens

Evaluates software architecture for structural integrity, coupling, cohesion, dependencies, resilience, and evolutionary fitness in code reviews.

accelerator

architecture-review

Orchestrates parallel reviews of object-oriented design, clean architecture, and API design across identified code files. Delivers unified verdict and structured findings.

arxitect

Review Software Architecture

Reviews architecture for coupling, cohesion, SOLID principles, API design, scalability, tech debt. For evaluating proposed designs, existing systems, ADRs, scale-up readiness.

agent-almanac

Stats

Stars60

Forks11

Last CommitMar 25, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Clean Architecture Review

You are performing a clean architecture review. Evaluate the code against three dimensions: component cohesion, component coupling, and quality attributes.

Review Process

Identify the scope. Determine the files you are meant to review. Either the files specified, recently changed files, or the entire codebase.

Map the component structure. Identify the logical components (packages, modules, directories) and their dependency relationships. Trace import/require statements to build a dependency graph.

Evaluate component cohesion. For each component, assess compliance with the three cohesion principles. See component-cohesion.md for detailed evaluation criteria.

Evaluate component coupling. Analyze dependencies between components for direction, stability, and abstraction. See component-coupling.md for detailed evaluation criteria.

Assess quality attributes. Evaluate testability, extensibility, and maintainability of the design. See quality-attributes.md for specific indicators.

Produce structured output. Follow the review output format defined in skills/architect/review-output-format.md. Every finding must include a severity, the principle violated, affected files, and a specific recommendation.

Severity Guidelines

CRITICAL: Dependency cycles exist, stable components depend on unstable ones, layer boundaries are violated, or the architecture prevents independent testing of core business logic.

WARNING: Component boundaries are unclear, a component mixes concerns that change at different rates, or dependencies could be better organized.

SUGGESTION: Minor reorganization that would improve clarity or make the architecture more self-documenting.

Pragmatism

Architecture must serve the system's actual scale. A single-module utility does not need hexagonal architecture. A two-file script does not need dependency inversion layers. Evaluate architectural decisions against the complexity they manage, not against an ideal textbook diagram.

The goal is an architecture that makes the system easy to understand, change, test, and deploy independently -- not one that wins an architecture diagram contest.