clean-architecture

name	clean-architecture
description	Clean Architecture principles and best practices from Robert C. Martin's book. This skill should be used when designing software systems, reviewing code structure, or refactoring applications to achieve better separation of concerns. Triggers on tasks involving layers, boundaries, dependency direction, entities, use cases, or system architecture.

Clean Architecture Best Practices

Comprehensive guide to Clean Architecture principles for designing maintainable, testable software systems. Based on Robert C. Martin's "Clean Architecture: A Craftsman's Guide to Software Structure and Design." Contains 42 rules across 8 categories, prioritized by architectural impact.

When to Apply

Reference these guidelines when:

• Designing new software systems or modules
• Structuring dependencies between layers
• Defining boundaries between business logic and infrastructure
• Reviewing code for architectural violations
• Refactoring coupled systems toward cleaner structure

Rule Categories by Priority

Priority	Category	Impact	Prefix
1	Dependency Direction	CRITICAL	dep-
2	Entity Design	CRITICAL	entity-
3	Use Case Isolation	HIGH	usecase-
4	Component Cohesion	HIGH	comp-
5	Boundary Definition	MEDIUM-HIGH	bound-
6