SkillsSKILLS
Productivity

clean-architecture▌

pproenca/dot-skills · updated Apr 8, 2026

$npx skills add https://github.com/pproenca/dot-skills --skill clean-architecture
summary

42 Clean Architecture rules organized by priority for designing maintainable, testable software systems.

  • ›Covers 8 rule categories from dependency direction and entity design (critical) through testing architecture (low-medium), each with specific guidance and code examples
  • ›Dependency rules enforce inward-pointing dependencies, interface ownership, and acyclic component graphs to prevent architectural decay
  • ›Entity and use case rules isolate business logic from frameworks, persistence,
skill.md

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 Interface Adapters MEDIUM adapt-
7 Framework Isolation MEDIUM frame-
8 Testing Architecture LOW-MEDIUM test-

Quick Reference

1. Dependency Direction (CRITICAL)

2. Entity Design (CRITICAL)

3. Use Case Isolation (HIGH)

4. Component Cohesion (HIGH)

5. Boundary Definition (MEDIUM-HIGH)

6. Interface Adapters (MEDIUM)

7. Framework Isolation (MEDIUM)

8. Testing Architecture (LOW-MEDIUM)

How to Use

Read individual reference files for detailed explanations and code examples:

Reference Files

File Description
references/_sections.md Category definitions and ordering
assets/templates/_template.md Template for new rules
metadata.json Version and reference information