use-case SKILL.md skillA

use-case from gbourgeat/ddd-ts-kit is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add gbourgeat/ddd-ts-kit/use-case@git:20261019.17189a9

Pins git:20261019.17189a9 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
gbourgeat/ddd-ts-kit
Path
plugin/skills/use-case/SKILL.md
Versions recorded
10
Latest version
git:20261019.17189a9, committed Oct 19, 2026
First version recorded
Oct 13, 2026
Size
11,074 bytes
Repository stars
7
License
MIT

Builds one vertical slice inside one bounded context, test first: the behaviour of the aggregate, the command or query with its permission, the handler, the route and their specs, generated then filled. Use when the user asks for a feature, an endpoint, a business rule or "add the ability to ...", or to build the next row of docs/architecture/slices.md. For a single file use scaffold; for a reaction to another context use integration-event.

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

# Build one use case

Context: `$0`. Use case: `$ARGUMENTS`

One use case, one context, one commit. Read `src/contexts/$0/CONTEXT.md` and the row of
`docs/architecture/slices.md` when there is one; do not browse the tree
(`npx ddd-ts-kit describe $0 --json` says what exists: use cases, routes, events, ports).

Write it in a worktree, not in the main checkout of the trunk (the guard refuses it there in a
project whose config says `"worktrees": "required"`): `npx ddd-ts-kit worktree <use-case>` opens
`.worktrees/<use-case>` on its own branch, installed; then every command is `cd <worktree> && ...`
and every file is written by its absolute path under it. A worktree of a story or of a worker
already is one.

## 1. State it in the domain's words

In five lines, before any command: who asks (the actor and the **permission**
`<aggregate>.<action>`, or public, said explicitly), what must be true before, what changes,
which fact is recorded, each way it can fail, by business name. Every noun and verb is in the
glossary, or is added with `--term`. Stop if the slice writes in two contexts: one decides,
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add gbourgeat/ddd-ts-kit/use-case@sha256:0e27153e1d356cf3

The line at the top of this page pins the label git:20261019.17189a9, 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_otunypf5tmd6yjvr.svg)](https://markdownregistry.com/a/art_otunypf5tmd6yjvr)

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

Versions

The registry has recorded 10 versions of this file, between Oct 13, 2026 and Oct 19, 2026, more than one a day.

versioncommittedcommitsizeaudit
git:20261019.17189a9 latest2026-10-19 17189a9 11,074 BA view · diff
git:20261018.9c6fa252026-10-18 9c6fa25 11,068 BA view · diff
git:20261018.87019472026-10-18 8701947 10,198 BA view · diff
git:20261018.9c453c52026-10-18 9c453c5 9,760 BA view · diff
git:20261017.bd3a8022026-10-17 bd3a802 9,033 BA view · diff
git:20261016.d4dd77b2026-10-16 d4dd77b 8,488 BA view · diff
git:20261015.55b91ed2026-10-15 55b91ed 8,474 BA view · diff
git:20261015.f9287bf2026-10-15 f9287bf 8,422 BA view · diff
git:20261015.b64badc2026-10-15 b64badc 8,383 BA view · diff
git:20261013.6c8cae82026-10-13 6c8cae8 7,802 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 (11074 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

gbourgeat/ddd-ts-kit · 7 stars · license MIT · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_otunypf5tmd6yjvr
GET https://markdownregistry.com/api/v1/resolve?ref=gbourgeat/ddd-ts-kit/use-case
GET https://markdownregistry.com/api/v1/blob/0e27153e1d356cf3e62b06024e55f404059fdd60503308feac2ae2593a3aff66

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 gbourgeat/ddd-ts-kit

AGENTS.md AGENTS.md file
gbourgeat/ddd-ts-kit · AGENTS.md
git:20261018.23c6a03 · audit A · 7 stars
CLAUDE.md CLAUDE.md file
gbourgeat/ddd-ts-kit · CLAUDE.md
git:20261013.35e7888 · audit B · 7 stars
AGENTS.md@examples/scheduling AGENTS.md file
gbourgeat/ddd-ts-kit · examples/scheduling/AGENTS.md
git:20261018.082015d · audit A · 7 stars
CLAUDE.md@examples/scheduling CLAUDE.md file
gbourgeat/ddd-ts-kit · examples/scheduling/CLAUDE.md
git:20261013.35e7888 · audit B · 7 stars
access-control SKILL.md skill
gbourgeat/ddd-ts-kit · plugin/skills/access-control/SKILL.md · Designs or reviews authentication and authorization in a ddd-ts-kit project. Every use case declares the permission it…
git:20261019.3419ca3 · audit A · 7 stars
bootstrap SKILL.md skill
gbourgeat/ddd-ts-kit · plugin/skills/bootstrap/SKILL.md · Chooses the stack by criteria and creates the project with the ddd-ts-kit CLI: config, composition root, platform…
git:20261019.27d866a · audit B · 7 stars
bounded-contexts SKILL.md skill
gbourgeat/ddd-ts-kit · plugin/skills/bounded-contexts/SKILL.md · Finds the bounded contexts of a system and classifies each as core, supporting or generic, from the domain discovery or…
git:20261010.c6c87e0 · audit A · 7 stars
clean-code SKILL.md skill
gbourgeat/ddd-ts-kit · plugin/skills/clean-code/SKILL.md · Clean Code rules of a ddd-ts-kit project for TypeScript under src/contexts. Business naming from the ubiquitous…
git:20261018.9c6fa25 · audit A · 7 stars
commit-discipline SKILL.md skill
gbourgeat/ddd-ts-kit · plugin/skills/commit-discipline/SKILL.md · Keeps commits small and meaningful in a ddd-ts-kit project. One use case or one concept per commit, generated files in…
git:20261012.e0454b0 · audit A · 7 stars
context-map SKILL.md skill
gbourgeat/ddd-ts-kit · plugin/skills/context-map/SKILL.md · Draws and maintains the context map of a ddd-ts-kit project. For every pair of contexts that collaborate, names the…
git:20261010.c6c87e0 · audit A · 7 stars
cross-cutting SKILL.md skill
gbourgeat/ddd-ts-kit · plugin/skills/cross-cutting/SKILL.md · Keeps technical concerns out of business code in a ddd-ts-kit project. Logging, metrics, tracing, error reporting, the…
git:20261019.3419ca3 · audit A · 7 stars
deviation SKILL.md skill
gbourgeat/ddd-ts-kit · plugin/skills/deviation/SKILL.md · Handles a request or a temptation to go around the architecture. Use when the user asks to skip a rule, do it quick and…
git:20261015.fd482a8 · audit A · 7 stars

Every file in gbourgeat/ddd-ts-kit

Other files named use-case

use-case SKILL.md skill
marielynneblock/arcanum-artifex · skills/analysis/use-case/SKILL.md · Produces a complete use case following the Cockburn/RUP format. A use case describes a goal-directed interaction…
v1.0.0 · audit A · 4 stars

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