clean-architecture

Define and apply clean architecture guidelines for software design.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/salesadriano/eventos --skill clean-architecture-salesadriano
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clean-architecture
Source: https://github.com/salesadriano/eventos/tree/main/.github/agents/skills/clean-architecture
Command: npx skills add https://github.com/salesadriano/eventos --skill clean-architecture-salesadriano

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Clean Architecture principles guide teams to structure software with clear boundaries, enforce dependency direction, and separate concerns to improve maintainability, testability, and adaptability across projects.

Core Features & Use Cases

  • Dependency-direction and boundary rules to prevent leakage between layers and to promote stable, testable codebases.
  • Layered architecture guidance that clearly separates domain, application, infrastructure, and interface responsibilities.
  • Use-case orchestration guidance: how use-cases coordinate entities while keeping business rules encapsulated in domain entities.
  • Extensive reference material, templates, and checklists to enforce consistent architectural decisions across teams.

Quick Start

Review your codebase, map components to boundaries, and start applying the dependency rules and use-case guidelines.

Frequently Asked Questions about clean-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enforce dependency direction rules in clean architecture?

To enforce dependency direction in clean architecture, you codify architectural rules that prevent leakage between layers, keeping dependencies pointing inward toward the domain. This Skill provides boundary definitions and verification checks to maintain stable, testable codebases.

What is the best way to separate domain and infrastructure layers?

The best way to separate domain and infrastructure layers is through disciplined layering that isolates business rules in domain entities. This Skill provides templates and guidance to clearly divide domain, application, infrastructure, and interface responsibilities.

How do I isolate use cases without leaking business logic?

To isolate use cases without leaking business logic, you orchestrate use-cases to coordinate entities while keeping business rules encapsulated in domain entities. This Skill codifies use-case isolation guidelines to ensure application logic remains separate from infrastructure.

Does clean architecture work for testing across complex domains?

Yes, clean architecture works for testing across complex domains by enforcing boundary definitions and dependency rules that prevent layer leakage. This approach promotes stable, testable codebases by isolating business rules from external interfaces and infrastructure concerns.

How do I start applying clean architecture boundaries to an existing codebase?

To start applying clean architecture boundaries to an existing codebase, review your components, map them to architectural boundaries, and apply the provided dependency rules and use-case guidelines. This Skill includes checklists and reference material to enforce consistent decisions.

When should I not use clean architecture layering?

You should reconsider clean architecture layering when your project lacks clear domain complexity or when strict boundary definitions would introduce unnecessary overhead. The architectural rules and verification checks are designed for teams needing maintainability across complex domains, services, and interfaces.