Architecture & Systems

Clean Architecture

Building maintainable, testable software architectures

Build maintainable software architectures using Robert C. Martin's Clean Architecture principles. This skill equips your AI agent with the Dependency Rule, layered architecture patterns, and boundary design that keeps business logic independent of frameworks and infrastructure.

Clean Architecture by Robert C. Martin

Clean Architecture

by Robert C. Martin

npx skills add wondelai/skills/clean-architecture

What your agent learns

The Dependency Rule

Dependencies point inward — outer layers depend on inner layers, never the reverse. Business rules know nothing about UI or databases.

Entities & Use Cases

Entities encapsulate enterprise-wide business rules. Use cases contain application-specific business rules that orchestrate entities.

Interface Adapters

Controllers, presenters, and gateways convert data between the format most convenient for use cases and the format used by external agencies.

Frameworks Are Details

Frameworks and databases are implementation details — keep them at the outer ring and make them replaceable.

SOLID Principles

Single Responsibility, Open-Closed, Liskov Substitution, Interface Segregation, and Dependency Inversion guide component design.

Robert C. Martin

Co-author of the Agile Manifesto, creator of SOLID principles

Robert C. Martin (Uncle Bob) is a software engineer, author, and co-author of the Agile Manifesto. He has been a programmer since 1970 and has shaped how the industry thinks about software design, from SOLID principles to clean architecture.

View Book →

Try these with the skill installed

Restructure this application to follow Clean Architecture layers using clean-architecture skill

Architecture

Identify Dependency Rule violations in this codebase using clean-architecture skill

Architecture review

Design use case and entity layers for this feature using clean-architecture skill

Design

Decouple the database layer so we can swap ORMs without touching business logic using clean-architecture skill

Refactoring

Install Clean Architecture

Free, open-source, and ready in 30 seconds.

npx skills add wondelai/skills/clean-architecture

MIT Licensed · Works with Claude Code, Cursor, Claude Cowork & OpenClaw · No account needed