clean-architecture SKILL.md skillA

This file is byte-identical to the first copy the registry indexed, one of 3 indexed copies. Same content hash, so the same checks give both the same grade.

clean-architecture from wondelai/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add wondelai/skills/clean-architecture@v1.4.0

Pins v1.4.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
wondelai/skills
Path
clean-architecture/SKILL.md
Versions recorded
5
Latest version
v1.4.0, committed Jun 30, 2026
First version recorded
Feb 23, 2026
Size
16,371 bytes
Repository stars
2,472
License
MIT

Structure software around the Dependency Rule: source code dependencies point inward from frameworks to use cases to entities. Use when the user mentions "architecture layers", "dependency rule", "ports and adapters (hexagonal)", "onion architecture", "screaming architecture", "where should business logic go", "decouple from the database", "swap the framework without a rewrite", or "keep business rules independent". Also trigger when deciding which layer code belongs in, isolating core logic…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Clean Architecture Framework

A disciplined approach to structuring software so that business rules remain independent of frameworks, databases, and delivery mechanisms. Apply these principles when designing system architecture, reviewing module boundaries, or advising on dependency management.

## Core Principle

**Source code dependencies must point inward — toward higher-level policies.** Nothing in an inner circle can know anything about an outer circle. This single rule produces systems that are testable and independent of frameworks, UI, database, and any external agency. Business rules are what matter; databases, web frameworks, and delivery mechanisms are details — when details depend on policies, you can defer decisions, swap implementations, and test business logic in isolation.

## Scoring
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add wondelai/skills/clean-architecture@sha256:fc9fe201ae040df8

The line at the top of this page pins the label v1.4.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_sdctptxq4jq2dimk.svg)](https://markdownregistry.com/a/art_sdctptxq4jq2dimk)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Feb 23, 2026 and Jun 30, 2026, about one every 32 days.

versioncommittedcommitsizeaudit
v1.4.0 latest2026-06-30 0dea03f 16,371 BA view · diff
v1.3.02026-06-24 5356d12 15,891 BA view · diff
v1.2.02026-06-10 968c871 15,690 BA view · diff
v1.1.02026-04-05 4d32253 20,475 BA view · diff
v1.0.02026-02-23 79593e3 20,258 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (16371 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

wondelai/skills · 2,472 stars · license MIT · pushed 2026-09-10 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_sdctptxq4jq2dimk
GET https://markdownregistry.com/api/v1/resolve?ref=wondelai/skills/clean-architecture
GET https://markdownregistry.com/api/v1/blob/fc9fe201ae040df80164bc7a407507882783e2c8cdbc0379a1fbdcf3719e4446

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from wondelai/skills

.cursorrules Cursor rule
wondelai/skills · .cursorrules
git:20260701.14a4958 · audit A · 2,472 stars
37signals-way SKILL.md skill
wondelai/skills · 37signals-way/SKILL.md · Build lean, opinionated products using the 37signals philosophy from "Getting Real", "Rework", and "Shape Up". Use when…
v1.3.1 · audit A · 2,472 stars
CLAUDE.md CLAUDE.md file
wondelai/skills · CLAUDE.md
git:20260829.6621b1f · audit A · 2,472 stars
architecture-optimization SKILL.md skill
wondelai/skills · architecture-optimization/SKILL.md · Guided journey from a working codebase grown slow and tangled to one measurably fast, cleanly bounded, and readable…
v1.0.0 · audit A · 2,472 stars
blue-ocean-strategy SKILL.md skill
wondelai/skills · blue-ocean-strategy/SKILL.md · Create uncontested market space using value innovation instead of competing head-to-head. Use when the user mentions…
v1.4.1 · audit A · 2,472 stars
clean-code SKILL.md skill
wondelai/skills · clean-code/SKILL.md · Write readable, maintainable code through disciplined naming, small functions, and clean error handling. Use when the…
v1.4.0 · audit A · 2,472 stars
cold-start-problem SKILL.md skill
wondelai/skills · cold-start-problem/SKILL.md · Start and scale networked products using Andrew Chen''s "The Cold Start Problem" framework for network effects. Use…
v1.2.0 · audit A · 2,472 stars
contagious SKILL.md skill
wondelai/skills · contagious/SKILL.md · Engineer word-of-mouth and virality using the STEPPS framework (Social Currency, Triggers, Emotion, Public, Practical…
v1.4.0 · audit A · 2,472 stars
continuous-discovery SKILL.md skill
wondelai/skills · continuous-discovery/SKILL.md · Build a weekly cadence of customer touchpoints using Opportunity Solution Trees, assumption mapping, and interview…
v1.4.0 · audit A · 2,472 stars
conversion-optimization SKILL.md skill
wondelai/skills · conversion-optimization/SKILL.md · Guided journey from a leaking conversion flow - landing page, signup, checkout, or in-app onboarding - to a measured…
v1.0.0 · audit A · 2,472 stars
create-app SKILL.md skill
wondelai/skills · create-app/SKILL.md · Guided journey from a raw app idea to a validated, cleanly architected first version that ships on a sustainable…
v1.0.1 · audit A · 2,472 stars
create-business SKILL.md skill
wondelai/skills · create-business/SKILL.md · Guided journey from raw idea to a validated, positioned, priced business with a chosen beachhead. Orchestrates ten…
v1.0.1 · audit A · 2,472 stars

Every file in wondelai/skills

Other files named clean-architecture

clean-architecture SKILL.md skill
ciembor/agent-rules-books · clean-architecture/SKILL.md · Apply Robert C. Martin-inspired architecture rules when separating business policy from frameworks, databases, UI, or…
git:20260909.802595f · audit A · 3,089 stars
clean-architecture SKILL.md skill
wondelai/skills · plugins/systems-architecture/skills/clean-architecture/SKILL.md · Structure software around the Dependency Rule: source code dependencies point inward from frameworks to use cases to…
v1.4.0 · audit A · 2,472 stars
clean-architecture SKILL.md skill
wondelai/skills · plugins/wondelai-skills/skills/clean-architecture/SKILL.md · Structure software around the Dependency Rule: source code dependencies point inward from frameworks to use cases to…
v1.4.0 · audit A · 2,472 stars
clean-architecture SKILL.md skill
giuseppe-trisciuoglio/developer-kit · plugins/developer-kit-php/skills/clean-architecture/SKILL.md · Provides implementation patterns for Clean Architecture, Hexagonal Architecture (Ports & Adapters), and Domain-Driven…
git:20260223.c6d4db1 · audit A · 359 stars
clean-architecture SKILL.md skill
giuseppe-trisciuoglio/developer-kit · plugins/developer-kit-typescript/skills/clean-architecture/SKILL.md · Provides implementation patterns for Clean Architecture, Domain-Driven Design (DDD), and Hexagonal Architecture (Ports…
git:20260323.227390f · audit A · 359 stars
clean-architecture SKILL.md skill
giuseppe-trisciuoglio/developer-kit · plugins/developer-kit-python/skills/clean-architecture/SKILL.md · Provides implementation patterns for Clean Architecture, Hexagonal Architecture (Ports & Adapters), and Domain-Driven…
git:20260223.c6d4db1 · audit A · 359 stars
clean-architecture SKILL.md skill
giuseppe-trisciuoglio/developer-kit · plugins/developer-kit-java/skills/clean-architecture/SKILL.md · Provides implementation patterns for Clean Architecture, Hexagonal Architecture (Ports & Adapters), and Domain-Driven…
git:20260324.a02e282 · audit A · 359 stars
clean-architecture SKILL.md skill
mindrally/skills · clean-architecture/SKILL.md · Guidelines for implementing Clean Architecture patterns in Flutter and Go applications, with emphasis on separation of…
git:20261008.7682ca7 · audit A · 278 stars

Browse by kind, by grade A, or by owner.