ddd-playbook SKILL.md skillA

ddd-playbook from salimramirez/agent-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add salimramirez/agent-skills/ddd-playbook@v2.0.1

Pins v2.0.1 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
salimramirez/agent-skills
Path
skills/ddd-playbook/SKILL.md
Versions recorded
5
Latest version
v2.0.1, committed Aug 31, 2026
First version recorded
Jun 23, 2026
Size
9,443 bytes
Repository stars
4
License
MIT

Model a business domain with Domain-Driven Design — bounded contexts, ubiquitous language, aggregates and their invariants, value objects, domain events, and context mapping. Use when designing or refactoring a domain model, deciding aggregate boundaries, splitting a system into bounded contexts, running or interpreting an EventStorming session, or when business rules are leaking into controllers, services, or UI components — even if the user never says "DDD". It covers the modeling and the…

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

# Domain-Driven Design (DDD)

Domain-Driven Design tackles complex software by putting the **business domain** — its language, rules, and invariants — at the center of the design, instead of letting the database schema, the framework, or the UI drive the model.

Apply this whenever you model a domain or write code around business logic. Follow the decision rules in this file; open a reference file when you need depth on a specific area. The rules matter more than any single example — understand *why* each exists so you can apply it to cases the examples don't spell out.

<!-- ddd:core:start -->

## Prime directive: model the domain, and protect it

- Put business rules and invariants **inside the domain model itself**, not scattered across controllers, services, or SQL. A model that only holds data while the logic lives elsewhere is an *anemic domain model* — the most common DDD failure, and the main thing DDD exists to prevent.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add salimramirez/agent-skills/ddd-playbook@sha256:e2365b13e9422053

The line at the top of this page pins the label v2.0.1, 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_snm3h7rxqcuhl5jg.svg)](https://markdownregistry.com/a/art_snm3h7rxqcuhl5jg)

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

Versions

The registry has recorded 5 versions of this file, between Jun 23, 2026 and Aug 31, 2026, about one every 17 days.

versioncommittedcommitsizeaudit
v2.0.1 latest2026-08-31 8ee61f6 9,443 BA view · diff
v2.0.02026-08-30 1d5f5ef 9,450 BA view · diff
v1.0.12026-08-30 1f17ab8 9,562 BA view · diff
v1.0.12026-08-30 fcb4ea9 8,992 BA view · diff
v1.0.12026-06-23 37e0cb1 8,977 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 (9443 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

salimramirez/agent-skills · 4 stars · license MIT · pushed 2026-10-13 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_snm3h7rxqcuhl5jg
GET https://markdownregistry.com/api/v1/resolve?ref=salimramirez/agent-skills/ddd-playbook
GET https://markdownregistry.com/api/v1/blob/e2365b13e9422053490716b1c309351cb1d3a13c7d841a26de1d392c2ea262ef

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 salimramirez/agent-skills

ddd-angular SKILL.md skill
salimramirez/agent-skills · skills/ddd-angular/SKILL.md · Structure an Angular frontend with Domain-Driven Design — bounded-context feature folders, a domain layer of entities…
v1.1.6 · audit A · 4 stars
ddd-aspnet-core SKILL.md skill
salimramirez/agent-skills · skills/ddd-aspnet-core/SKILL.md · Write Domain-Driven Design code in ASP.NET Core / C# — bounded contexts as folders with four layers, aggregate roots…
v1.0.0 · audit A · 4 stars
ddd-fastapi SKILL.md skill
salimramirez/agent-skills · skills/ddd-fastapi/SKILL.md · Write Domain-Driven Design code in FastAPI / Python — bounded contexts as packages with four layers, aggregates as…
v1.0.0 · audit A · 4 stars
ddd-react SKILL.md skill
salimramirez/agent-skills · skills/ddd-react/SKILL.md · Structure a React frontend with Domain-Driven Design — bounded-context feature folders, a domain layer of immutable…
v1.0.2 · audit A · 4 stars
ddd-spring-boot SKILL.md skill
salimramirez/agent-skills · skills/ddd-spring-boot/SKILL.md · Write Domain-Driven Design code in Spring Boot / Java — the four-layer package structure, aggregate roots as JPA…
v1.1.0 · audit A · 4 stars
ddd-vue SKILL.md skill
salimramirez/agent-skills · skills/ddd-vue/SKILL.md · Structure a Vue frontend with Domain-Driven Design — bounded-context feature folders, a domain layer of entity and…
v1.1.0 · audit B · 4 stars

Every file in salimramirez/agent-skills

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