ddd-aggregates SKILL.md skillA

ddd-aggregates from ninjasln-labs/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 ninjasln-labs/agent-skills/ddd-aggregates@v1.1.0

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

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
ninjasln-labs/agent-skills
Path
ddd-aggregates/SKILL.md
Versions recorded
5
Latest version
v1.1.0, committed Sep 29, 2026
First version recorded
Aug 3, 2026
Size
8,730 bytes
Repository stars
3
License
none declared

Design DDD aggregates and aggregate boundaries from invariants: aggregate roots, entities, value objects, transaction boundaries, and cross-aggregate consistency strategies. Use when designing aggregate boundaries, invariants, transaction boundaries, or cross-aggregate consistency.

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

# DDD Aggregates

> English version: [English](SKILL.en.md)

## 使用时机

- 限界上下文与集成策略已就绪,需要设计上下文内部的构造块。
- 需要回答"哪些对象必须一起变更以保持一致性"。
- `ddd-model-review` 报告"不变量表达率 < 60%",或 `ddd-domain-interactions` 报告"事件需携带另一聚合私有数据"时,作为回溯目标重新执行。

## 输入要求

- **必需**:事件流与命令候选(来自 `ddd-discover`)、上下文目录与词汇表(来自 `ddd-contexts`)。
- **可选**:上下文映射与失败模式(来自 `ddd-context-map`)。

## 流程

1. **提取不变量**:从命令与事件中提取"必须始终为真"的业务规则(不变量)。
2. **聚类对象**:以不变量为纽带,将对象聚类为聚合候选;明确聚合根(唯一外部入口)。
3. **识别构造块**:区分聚合内的实体(有标识、有生命周期)与值对象(无标识、不可变、按值比较)。
4. **定义边界规则**:外部只持有聚合根引用;跨聚合引用使用 ID;每个聚合是一个事务边界。
   - **外部引用再审视**:对模型中每一个"外部引用对象"(foreign reference),再问一遍——我们自己是否需要管理它的生命周期(创建、修改、终结)?若答案为是,它应被提升为 **内部聚合**,而不是仅保留 ID 引用。典型触发器:参考数据类对象(港口目录、日历、线路目录)若由我方维护,必须列为聚合。
   - **Specification 模式识别**:当某条业务规则以"给定 X,X 是否满足 Y"的谓词形式出现(如 `isSatisfiedBy(Itinerary)`),显式抽取为 Specification,而不是塞进工厂或服务内部的 if 分支。
5. **命令边界**:为每个聚合定义它处理的命令、前置验证、副作用。
6. **跨聚合一致性**:聚合内强一致;聚合间最终一致——定义事件驱动 / 补偿 / 重试策略。
7. **仓储接口草案**:为每个聚合产出仓储接口的语义定义(方法名 + 语义,不含代码实现)。

## 输出

| 工件             | 结构要求                                                         |
| :--------------- | :--------------------------------------------------------------- |
| 聚合目录         | 表格:聚合名、聚合根、包含实体、包含值对象、关键不变量、关键命令 |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ninjasln-labs/agent-skills/ddd-aggregates@sha256:d94890f9d518c88b

The line at the top of this page pins the label v1.1.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_r5f542kccipgyawv.svg)](https://markdownregistry.com/a/art_r5f542kccipgyawv)

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

Versions

The registry has recorded 5 versions of this file, between Aug 3, 2026 and Sep 29, 2026, about one every 14 days.

versioncommittedcommitsizeaudit
v1.1.0 latest2026-09-29 0febb7a 8,730 BA view · diff
v1.0.12026-09-22 75c75c0 4,936 BA view · diff
v1.0.02026-09-07 571fb57 4,941 BA view · diff
git:20260803.cf548c92026-08-03 cf548c9 4,877 BA view · diff
git:20260803.db146312026-08-03 db14631 4,849 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 (8730 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

ninjasln-labs/agent-skills · 3 stars · license none declared · pushed 2026-10-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_r5f542kccipgyawv
GET https://markdownregistry.com/api/v1/resolve?ref=ninjasln-labs/agent-skills/ddd-aggregates
GET https://markdownregistry.com/api/v1/blob/d94890f9d518c88b0de528a35ef9c47939765d3c9f634a9fc14052cdadde751c

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 ninjasln-labs/agent-skills

accessibility-auditor SKILL.md skill
ninjasln-labs/agent-skills · accessibility-auditor/SKILL.md · Comprehensive WCAG 2.1 AA compliance testing combining automated axe-core scans with manual keyboard navigation and…
v1.2.0 · audit A · 3 stars
agent-dispatch SKILL.md skill
ninjasln-labs/agent-skills · agent-dispatch/SKILL.md · User-invoked only: run it when the user explicitly asks to hand work to an external agent CLI, never on your own…
v1.5.6 · audit A · 3 stars
api-contract-validator SKILL.md skill
ninjasln-labs/agent-skills · api-contract-validator/SKILL.md · Validate API responses against OpenAPI/Swagger specifications, JSON Schema definitions, and GraphQL schemas to prevent…
v1.1.1 · audit A · 3 stars
architecture-patterns SKILL.md skill
ninjasln-labs/agent-skills · architecture-patterns/SKILL.md · Implement proven backend architecture patterns including Clean Architecture, Hexagonal Architecture, and Domain-Driven…
v1.2.0 · audit A · 3 stars
audit-item SKILL.md skill
ninjasln-labs/agent-skills · audit-item/SKILL.md · Track audit/review findings as numbered issue files (audit-items/NNN-slug.md, under the directory the project keeps…
v1.1.0 · audit A · 3 stars
autonomous-investigation SKILL.md skill
ninjasln-labs/agent-skills · autonomous-investigation/SKILL.md · The evidence protocol behind recurring competitive and market investigation skills — market scans, competitive…
v1.2.0 · audit A · 3 stars
battle-card-builder SKILL.md skill
ninjasln-labs/agent-skills · battle-card-builder/SKILL.md · Research and draft a competitive battle card from public evidence — every claim labeled and sourced. Use when a rep…
v1.1.1 · audit A · 3 stars
cicd-pipeline SKILL.md skill
ninjasln-labs/agent-skills · cicd-pipeline/SKILL.md · Configure testing in CI/CD pipelines for GitHub Actions, Jenkins, and GitLab CI: shards, parallelization, wait-on…
v1.2.0 · audit A · 3 stars
code-review SKILL.md skill
ninjasln-labs/agent-skills · code-review/SKILL.md · Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes — Standards (does the code…
v1.1.0 · audit A · 3 stars
codebase-design SKILL.md skill
ninjasln-labs/agent-skills · codebase-design/SKILL.md · Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find…
v1.0.1 · audit A · 3 stars
company-intel SKILL.md skill
ninjasln-labs/agent-skills · company-intel/SKILL.md · Research a company, industry, or competitor set using web search and seven analytical lenses. Use when you need…
v1.1.1 · audit A · 3 stars
competitive-analysis-process SKILL.md skill
ninjasln-labs/agent-skills · competitive-analysis-process/SKILL.md · Orchestrate a complete competitive analysis end to end: market landscape, product-level comparison, ability to fulfill…
v1.1.1 · audit A · 3 stars

Every file in ninjasln-labs/agent-skills

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