clean-architecture-review

Analyze code changes for clean architecture compliance and dependency direction.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/silvio-l/copilot-skills --skill clean-architecture-review-silvio-l
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clean-architecture-review
Source: https://github.com/silvio-l/copilot-skills/tree/main/clean-architecture-review
Command: npx skills add https://github.com/silvio-l/copilot-skills --skill clean-architecture-review-silvio-l

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Verify that code, changes, or architecture decisions maintain clean responsibilities and stable dependencies.

Core Features & Use Cases

  • Identify correct layer assignment for logic
  • Detect boundary and dependency issues
  • Suggest concrete improvements with minimal intervention
  • Ensure solution remains local and maintainable

Quick Start

Name the relevant layers and run a review against the target changes.

Frequently Asked Questions about clean-architecture-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if my code changes violate clean architecture layering rules?

To detect boundary violations and dependency issues in your codebase, run an architecture review targeting the modified files. It analyzes layer responsibilities, identifies coupling risks from misplaced concerns, and suggests minimal interventions to keep the solution local and maintainable.

What is the best way to audit code for clean architecture alignment?

Auditing code for clean architecture alignment involves analyzing layer responsibilities and dependency direction across modules. The review detects coupling risks and boundary violations, returning concrete improvements with minimal intervention to ensure the solution remains local and maintainable.

Can I use this architecture review tool on any project codebase?

This architecture review tool applies specifically to project codebases with layered architectures. It targets boundary correctness, dependency direction, and maintainability across modules, identifying layer responsibilities and coupling risks to return concrete improvement recommendations.

How do I identify correct layer assignment for business logic during refactoring?

To identify correct layer assignment for business logic during refactoring, run an architecture review that analyzes layer responsibilities and detects misplaced concerns. It identifies coupling risks and returns concrete recommendations to ensure logic resides in the appropriate layer.

Why does my refactored code have coupling risks and boundary violations?

Coupling risks and boundary violations occur when logic is assigned to incorrect layers or dependencies point in the wrong direction. An architecture review identifies these misplaced concerns and suggests minimal interventions to maintain stable dependencies and correct boundaries.

Do I need to specify my architectural layers before running an architecture review?

Yes, you need to name the relevant layers before running an architecture review. This allows the review to accurately assess boundary correctness, dependency direction, and layer responsibilities across your project codebase, ensuring clean architecture compliance.