clean-architecture

Enforce clean architecture principles for module design and boundary contracts.

Updated Jan 31, 2026
One-click install
npx skills add https://github.com/lekman/cdn --skill clean-architecture-lekman
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clean-architecture
Source: https://github.com/lekman/cdn/tree/main/.claude/skills/clean-architecture
Command: npx skills add https://github.com/lekman/cdn --skill clean-architecture-lekman

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enforces clean architecture principles to guide module design and boundary contracts, reducing architectural drift and confusion across teams.

Core Features & Use Cases

  • Provides a structured set of principles for organizing code into Business Logic (inner), Interface (boundary), and System Implementation (outer) layers.
  • Encourages per-boundary boundaries, module-based folders, and barrel exports to improve maintainability and testability.
  • Use during architecture reviews, refactors, and new module design to ensure clear ownership and separation of concerns.

Quick Start

Apply the clean-architecture guidelines when starting a new module to ensure boundaries.

Frequently Asked Questions about clean-architecture

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

FAQPage Schema
How do I enforce clean architecture boundaries during a module refactor?

To enforce clean architecture boundaries during a module refactor, apply structured principles that separate code into Business Logic, Interface, and System Implementation layers. This ensures inward dependencies and clear separation of concerns for maintainable modules.

What is the best way to prevent architectural drift across development teams?

Preventing architectural drift requires codifying per-boundary interfaces and modularization requirements. By enforcing clear ownership and separation of concerns during architectural reviews, teams reduce confusion and maintain consistent module design.

Can I use clean architecture guidelines for system design across different platforms?

Yes, you can apply clean architecture guidelines across languages and platforms during system design. The guidelines codify inward dependencies, per-boundary interfaces, and modularization requirements independent of any specific technology stack.

How do I organize code folders to improve maintainability and testability?

Organize code folders using module-based structures and barrel exports to improve maintainability and testability. This approach enforces per-boundary interfaces and separates Business Logic from System Implementation layers for clearer ownership.

When do I need to define per-boundary interfaces for a new module?

Define per-boundary interfaces when starting a new module to ensure boundaries and separation of concerns. This practice prevents architectural drift by codifying contracts between Business Logic, Interface, and System Implementation layers.

Why does separating business logic from system implementation reduce architectural confusion?

Separating business logic from system implementation reduces confusion by enforcing inward dependencies. This separation ensures the inner Business Logic layer remains isolated behind boundary interfaces, making module ownership and architectural contracts explicit.