Skip to main content
skill CX Codex

clean-architecture · ciembor — Claude Code skill: what it does, how to install

This Claude Code skill applies clean architecture principles to decisions about separating business policy from implementation details. It activates for work on dependency direction, use cases, and application boundaries.

MIT 645 installs ★ 3,328 updated 2026-09-10

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add ciembor/agent-rules-books --skill clean-architecture -a claude-code
Open on GitHub

What clean-architecture does

The skill guides the separation of business rules from frameworks, databases, UI, and infrastructure. Its rules cover architectural boundaries, dependency direction, entities, use cases, and interface adapters.

The agent reads clean-architecture.mini.md before making design or code decisions. It consults clean-architecture.md for a specific tradeoff only when the shorter rules are insufficient.

What it helps with

  • separate business policy from framework code
  • set dependency direction across layers
  • define entities and use cases
  • isolate application design from technology changes

Example prompts for the agent

  • Separate this project's business rules from its framework using clean architecture principles.
  • Check the dependency direction between the application layers.
  • Suggest boundaries for adapters in this use case.

How to install clean-architecture

1Skills CLI (Vercel)

npx skills add ciembor/agent-rules-books --skill clean-architecture -a claude-code

2Manually: put the files in place

~/.claude/skills/clean-architecture/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/clean-architecture/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about clean-architecture

How do I install clean-architecture in Claude Code?

Run npx skills add ciembor/agent-rules-books --skill clean-architecture -a claude-code. The skill file is placed at ~/.claude/skills/clean-architecture/SKILL.md.

What does clean-architecture do?

It guides architectural decisions that separate business policy from implementation details. The rules address dependencies, entities, use cases, and interface adapters.

When does clean-architecture use its detailed reference?

The agent first reads clean-architecture.mini.md. It turns to clean-architecture.md when the shorter rules do not cover the current architectural tradeoff.

Source text

SKILL.md · MIT
---
name: clean-architecture
description: Apply Robert C. Martin-inspired architecture rules when separating business policy from frameworks, databases, UI, or infrastructure details.
license: MIT
---

# Clean Architecture Skill

Use this skill when a task involves architectural boundaries, dependency direction, use cases, entities, interface adapters, framework isolation, or technology churn.

Before making design or code decisions, read and apply [clean-architecture.mini.md](clean-architecture.mini.md). Use [clean-architecture.md](clean-architecture.md) only as a deeper reference when the mini rules are not enough for the current architectural tradeoff.

© ciembor · MIT · ciembor/agent-rules-books

Similar skills

All skills for Code review and refactoring →

clean-architecture by other authors comes first.

clean-architecture wondelai clean-architecture — a skill that keeps business rules independent of framework and database by enforcing one rule: source code dependencies point inward. CX Codex +1 8,000installs clean-architecture codewithmukesh clean-architecture — a skill that lays out .NET code across four projects, keeps dependencies pointing inward, and shows where use case handlers belong. CX Codex +1 4,200installs clean-architecture giuseppe-trisciuoglio Skill for designing layered Java 21+ and Spring Boot 3.5+ applications. Separates business logic from the framework by uniting Clean Architecture, Hexagonal Architecture, and Domain-Driven Design into one system. CX Codex +1 4,200installs clean-architecture pproenca clean-architecture — a skill with 42 rules from Robert C. Martin's book: it tells the agent which way dependencies should point and where layer boundaries belong. CX Codex +1 2,100installs clean-architecture Mindrally This skill guides Clean Architecture work in Flutter and Go. Use it when layer boundaries, dependency direction, and testable business logic matter. CX Codex +1 1,100installs python-clean-architecture MKToronto python-clean-architecture provides Clean Architecture guidance for Python and FastAPI projects. It checks layer boundaries, inspects coupling, and generates service scaffolding inside Claude Code. ★ 11repo stars go-backend-clean-architecture rebyteai-template go-backend-clean-architecture scaffolds a Go backend in the current folder: Gin, MongoDB, JWT auth and Clean Architecture layers, from clone to first run. CX Codex +1 105installs architecture-review decebals architecture-review — a skill that reviews a Java project at the macro level: package layout, module boundaries, dependency direction and layering. Useful once a codebase grows past the point where you can hold its structure in your head. CX Codex +1 394installs code-architecture curiositech code-architecture is a Claude Code skill for organizing code within a single application. It covers clean and hexagonal architecture, feature-based folders, dependency inversion, and module boundaries. CX Codex +1 169installs android-clean-architecture affaan-m android-clean-architecture tells the agent how to split an Android or KMP project into layers: modules, dependency rules, UseCases, repositories, plus Room, SQLDelight and Ktor patterns. CX Codex +1 7,200installs architecture-advisor codewithmukesh architecture-advisor runs a questionnaire on domain, team and system lifetime, then recommends an architecture for your .NET project. Useful before you lay out folders. CX Codex +1 4,000installs

From the same set14

The whole set →
clean-code This Claude Code skill applies clean-code guidance to readability, naming, and function design. It activates during everyday coding and test-related tasks. CX Codex +1 683installs refactoring This Claude Code skill applies Martin Fowler-inspired rules to refactoring. It activates for code-structure changes that preserve observable behavior. CX Codex +1 670installs a-philosophy-of-software-design The a-philosophy-of-software-design Claude Code skill applies software design principles to complexity, module boundaries, APIs, and abstractions. It activates during design reviews or refactoring of shallow interfaces. CX Codex +1 643installs code-complete The code-complete Claude Code skill applies software construction rules to routines, classes, control flow, defensive code, and tests. It activates for implementation and design tasks. CX Codex +1 611installs release-it The release-it Claude Code skill applies production reliability rules to failure handling, timeouts and retries. It activates on tasks involving integration failures, deployment or operational readiness. CX Codex +1 607installs the-pragmatic-programmer the-pragmatic-programmer — a skill for Claude Code and Codex applying Hunt and Thomas-inspired engineering guidelines. Triggers during architecture decisions, automation work, and code refactoring. CX Codex +1 603installs working-effectively-with-legacy-code working-effectively-with-legacy-code — a skill for Claude Code and Codex that enforces Michael Feathers' legacy code techniques. Activates during risky refactoring, missing test coverage, and dependency breaking. CX Codex +1 602installs refactoring-guru refactoring-guru — a skill for Claude Code helps diagnose code smells and choose focused refactoring techniques. The agent applies its rules to code changes while preserving behavior. CX Codex +1 598installs

Project sponsors

Companies that keep this analytics open