clean-architecture

Enforce Clean Architecture layering and dependency rules in code reviews.

Updated Feb 12, 2026
One-click install
npx skills add https://github.com/lucas-martino/ai-augmented-development-agents --skill clean-architecture-lucas-martino
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clean-architecture
Source: https://github.com/lucas-martino/ai-augmented-development-agents/tree/main/skills/clean-architecture
Command: npx skills add https://github.com/lucas-martino/ai-augmented-development-agents --skill clean-architecture-lucas-martino

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps software developers implement clean and maintainable code by enforcing the principles of Clean Architecture, which ensures separation of concerns and promotes long-term code stability.

Core Features & Use Cases

  • Layered Architecture: Enforces the Clean Architecture pattern, including Entities, Use Cases, Interface Adapters, and Frameworks & Drivers.
  • Mandatory Heuristics: Guides the implementation of dependency rules, screaming architecture, dependency inversion, and data isolation.
  • Review Checklist: Provides a structured checklist for reviewing the code to ensure adherence to Clean Architecture principles.

Quick Start

Apply the clean-architecture skill to analyze your project and generate a report that identifies areas for improvement.

Frequently Asked Questions about clean-architecture

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

FAQPage Schema
What is clean architecture and how does it enforce separation of concerns in software development?

Clean architecture is a layered architecture pattern that enforces separation of concerns by dividing code into Entities, Use Cases, Interface Adapters, and Frameworks. This structure ensures dependency rules isolate business logic from external frameworks, promoting maintainability and long-term code stability.

How do I implement dependency inversion and data isolation in my project's code structure?

To implement dependency inversion and data isolation in your code structure, apply mandatory heuristics that enforce dependency rules across architectural layers. This ensures inner layers like Entities remain independent of outer frameworks, keeping data isolation intact and maintaining a screaming architecture design.

Can I use this approach to review an existing codebase for adherence to layered architecture principles?

Yes, you can review an existing codebase for adherence to layered architecture principles by applying a structured review checklist. This process analyzes your project's code structure against mandatory heuristics, generating a report that identifies areas for architectural improvement and dependency rule violations.

What's the best way to structure code so that business logic is independent of frameworks and drivers?

The best way to structure code independent of frameworks and drivers is to apply the clean architecture pattern. By organizing code into strict layers from Entities to Frameworks, you enforce dependency inversion, ensuring core business rules remain isolated and maintainable regardless of external dependencies.

When should I not use clean architecture for my software development project?

You should not use clean architecture when your software development project has minimal complexity or requires rapid prototyping. The strict layering, multiple abstraction boundaries, and mandatory heuristics introduce structural overhead that may outweigh the maintainability benefits for small or simple codebases.