
Clean Architecture
When you're designing a new system or refactoring toward better separation of concerns, this gives you 42 prioritized rules from Uncle Bob's Clean Architecture book. It's organized into eight categories from critical dependency direction rules to testing concerns, each with a clear impact level. The structure is helpful: you can jump straight to the six critical dependency rules when reviewing if your business logic is leaking framework imports, or check the use case isolation section when orchestration starts mixing with presentation. Think of it as a structured checklist that keeps you honest about where boundaries should exist and whether you're actually respecting them in practice.
- skills.sh installs
- 2K
- GitHub stars
- 222
- last updated
- Aug 21, 2026
Install
$ npx -y skills add pproenca/dot-skills --skill clean-architecture --agent claude-codeInstalls into .claude/skills of the current project.
Files
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)
Sponsors
Details
- Repository
- github.com/pproenca/dot-skills
- Category
- Code Review & Quality
More from pproenca/dot-skills
All 100- Typescript1.8K
- Code Simplifier1.6K
- Expo React Native Performance1.5K
- Nextjs1.2K
- Playwright1.2K
- Framer Motion1.2K
- Wxt Browser Extensions1.1K
- Msw897
- Tanstack Query858
- Clean Code857
- Terminal Ui853
- Ui Design827
- Typescript Refactor799
- React Refactor791
- Chrome Extension Ui732
- Shadcn732
- Chrome Extension729
- Shell704
- Tailwind657
- Refactor651
- Expo561
- React496
- Tailwind Responsive Ui470
- Tailwind Ui Refactor467