pproenca avatar

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-code

Installs 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

PriorityCategoryImpactPrefix
1Dependency DirectionCRITICALdep-
2Entity DesignCRITICALentity-
3Use Case IsolationHIGHusecase-
4Component CohesionHIGHcomp-
5Boundary DefinitionMEDIUM-HIGHbound-
6Interface AdaptersMEDIUMadapt-
7Framework IsolationMEDIUMframe-
8Testing ArchitectureLOW-MEDIUMtest-

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
1metabase avatardocs-reviewmetabase/metabaseReview documentation changes for compliance with the Metabase writing style guide. Use when reviewing pull requests, files, or diffs containing documentation ma2Kskills.sh installs
2minimax-ai avatarpr-reviewminimax-ai/skillsReview pull requests for the MiniMax Skills repository. Use when reviewing PRs, validating new skill submissions, or checking existing skills for compliance. Ru1.8Kskills.sh installs
3alirezarezvani avatarreviewalirezarezvani/claude-skillsReview Playwright tests for quality. Use when user says "review tests", "check test quality", "audit tests", "improve tests", "test code review", or "playwright1.7Kskills.sh installs
4github avatarquality-playbookgithub/awesome-copilotRun a complete quality engineering audit on any codebase. Derives behavioral requirements from the code, generates spec-traced functional tests, runs a three-pa1.6Kskills.sh installs
5alirezarezvani avataraws-solution-architectalirezarezvani/claude-skillsDesign AWS architectures for startups using serverless patterns and IaC templates. Use when asked to design serverless architecture, create CloudFormation templ1.6Kskills.sh installs
6johnrogers avatarswift-stylejohnrogers/claude-swift-engineeringSwift code style conventions for clean, readable code. Use when writing Swift code to ensure consistent formatting, naming, organization, and idiomatic patterns1.5Kskills.sh installs