clean-architecture

Organize software into inward-facing boundaries that protect business rules from infrastructure.

3|2|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/wesleyegberto/software-engineering-skills --skill clean-architecture-wesleyegberto
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clean-architecture
Source: https://github.com/wesleyegberto/software-engineering-skills/tree/main/plugins/programming-skills/skills/clean-architecture
Command: npx skills add https://github.com/wesleyegberto/software-engineering-skills --skill clean-architecture-wesleyegberto

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Structure software so that business rules remain independent of frameworks, databases, and delivery mechanisms by organizing code into concentric circles and clearly drawn boundaries.

Core Features & Use Cases

  • Clarifies the Dependency Rule, concentric circles, and boundary anatomy.
  • Provides guidance on using Use Cases, Entities, Interface Adapters, and Frameworks as plugins.
  • Includes reference materials and practical diagnostic questions for maintaining architecture.

Quick Start

Apply the Clean Architecture principles to a new module by identifying inner and outer circles, then implement a minimal interactor and its ports.

Frequently Asked Questions about clean-architecture

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

FAQPage Schema
How do I structure software to keep business rules independent of frameworks and databases?

Clean Architecture organizes software into concentric circles with inward-facing boundaries, ensuring business rules remain independent of frameworks, databases, and delivery mechanisms.

What is the Dependency Rule in clean architecture and how does it protect entities?

The Dependency Rule mandates that dependencies point inward toward inner circles, protecting Entities and Use Cases from infrastructure changes by enforcing boundary anatomy.

How do I apply clean architecture to a new module step by step?

Identify inner and outer circles, then implement a minimal interactor and its ports to apply clean architecture principles, using Interface Adapters and Frameworks as plugins.

Can I use clean architecture for system refactoring and architecture reviews?

Yes, clean architecture applies to architecture reviews, code design, and system refactoring by providing practical diagnostic questions to maintain boundaries and SOLID-guided practices.

What is the best way to wire frameworks as plugins in a clean architecture design?

Use the Main composition pattern to wire frameworks as plugins, prescribing ports and adapters to enforce the Dependency Rule and isolate infrastructure from use cases.

When should I not use clean architecture for my software design?

Clean architecture may introduce unnecessary complexity for small modules; consider skipping it when rapid prototyping or when infrastructure isolation is not a primary concern.