CommunityCodierung & Entwicklunggithub.com

mattpocock/domain-modeling

Erstellt und schärft das Domänenmodell eines Projekts. Verwende diesen Skill, wenn der Benutzer Domänenbegriffe oder eine ubiquitäre Sprache festlegen, eine Architekturentscheidung dokumentieren möchte, oder wenn ein anderer Skill das Domänenmodell pflegen muss.

Was ist domain-modeling?

Dieser Skill dient der aktiven Modellierung und Schärfung des Domänenmodells eines Projekts. Er geht über das bloße Lesen einer `CONTEXT.md` hinaus – er wird eingesetzt, wenn Begriffe hinterfragt, Randfälle erfunden und das Glossar sowie Entscheidungen direkt festgehalten werden sollen, sobald sie sich kristallisieren. Unterstützt werden Projekte mit einem einzigen Kontext (`CONTEXT.md` im Root) oder mit mehreren Kontexten (gesteuert durch eine `CONTEXT-MAP.md`). Der Skill beschreibt die Dateistruktur, definiert klare Regeln für die Interaktion (z. B. Herausfordern unklarer Begriffe, Vorschlagen präziser Terminologie, Diskussion konkreter Szenarien, Querverweise auf den Code) und zeigt, wie `CONTEXT.md` als reines Glossar ohne Implementierungsdetails geführt wird. Architekturentscheidungen (ADRs) werden nur dann angeboten, wenn sie schwer rückgängig zu machen, ohne Kontext überraschend und das Ergebnis echter Abwägungen sind – ansonsten werden sie weggelassen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mattpocock/skills/tree/main/skills/engineering/domain-modeling

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Domänenmodellierung

Baue das Domänenmodell des Projekts aktiv auf und schärfe es während des Entwurfs. Dies ist die aktive Disziplin – Begriffe hinterfragen, Randfallszenarien erfinden und das Glossar sowie Entscheidungen genau dann dokumentieren, wenn sie sich kristallisieren. (Das bloße Lesen von CONTEXT.md für Vokabular ist nicht dieser Skill – das ist eine einzeilige Gewohnheit, die jeder Skill ausführen kann. Dieser Skill ist für den Moment, in dem du das Modell änderst, nicht nur konsumierst.)

Dateistruktur

Die meisten Repos haben einen einzigen Kontext:

/
├── CONTEXT.md
├── docs/
│   └── adr/
│       ├── 0001-event-sourced-orders.md
│       └── 0002-postgres-for-write-model.md
└── src/

Wenn im Root eine CONTEXT-MAP.md existiert, hat das Repo mehrere Kontexte. Die Map zeigt, wo sich jeder Kontext befindet:

/
├── CONTEXT-MAP.md
├── docs/
│   └── adr/                          ← systemweite Entscheidungen
├── src/
│   ├── ordering/
│   │   ├── CONTEXT.md
│   │   └── docs/adr/                 ← kontextspezifische Entscheidungen
│   └── billing/
│       ├── CONTEXT.md
│       └── docs/adr/

Erstelle Dateien nur bei Bedarf – nur wenn du etwas zu schreiben hast. Wenn keine CONTEXT.md existiert, erstelle sie, sobald der erste Begriff festgelegt ist. Wenn kein docs/adr/ existiert, erstelle es, sobald die erste ADR benötigt wird.

Während der Sitzung

Glossar herausfordern

Wenn der Benutzer einen Begriff verwendet, der mit der vorhandenen Sprache in CONTEXT.md kollidiert, weise sofort darauf hin. „Dein Glossar definiert ‚Stornierung‘ als X, aber du scheinst Y zu meinen – was ist es nun?“

Vage Sprache schärfen

Wenn der Benutzer vage oder überladene Begriffe verwendet, schlage einen präzisen kanonischen Begriff vor. „Du sagst ‚Konto‘ – meinst du den Kunden oder den Benutzer? Das sind verschiedene Dinge.“

Konkrete Szenarien diskutieren

Wenn über Domänenbeziehungen gesprochen wird, prüfe sie mit konkreten Szenarien auf Herz und Nieren. Erfinde Szenarien, die Randfälle ausloten und den Benutzer zwingen, präzise über die Grenzen zwischen Konzepten zu sprechen.

Mit Code abgleichen

Wenn der Benutzer sagt, wie etwas funktioniert, überprüfe, ob der Code dem zustimmt. Wenn du einen Widerspruch findest, sprich ihn an: „Dein Code storniert ganze Bestellungen, aber du hast gerade gesagt, dass Teilstornierungen möglich sind – was ist richtig?“

CONTEXT.md direkt aktualisieren

Wenn ein Begriff festgelegt ist, aktualisiere CONTEXT.md sofort. Sammle sie nicht auf – halte sie fest, sobald sie passieren. Verwende das Format aus CONTEXT-FORMAT.md.

CONTEXT.md sollte völlig frei von Implementierungsdetails sein. Behandle CONTEXT.md nicht als Spezifikation, Notizblock oder Ablage für Implementierungsentscheidungen. Es ist ein Glossar und nichts weiter.

ADRs zurückhaltend anbieten

Biete nur dann an, eine ADR zu erstellen, wenn alle drei Bedingungen zutreffen:

  1. Schwer rückgängig zu machen – die Kosten, später seine Meinung zu ändern, sind signifikant
  2. Ohne Kontext überraschend – ein zukünftiger Leser wird sich fragen „warum haben sie es so gemacht?“
  3. Das Ergebnis eines echten Abwägens – es gab echte Alternativen und du hast dich aus bestimmten Gründen für eine entschieden

Wenn eine der drei Bedingungen fehlt, überspringe die ADR. Verwende das Format aus ADR-FORMAT.md.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

mattpocock/ask-matt

Ask which skill or flow fits your situation. A router over the skills in this repo.

mattpocock/caveman

Ultra-compressed communication mode. Cuts token usage ~75% by dropping filler, articles, and pleasantries while keeping full technical accuracy. Use when user says "caveman mode", "talk like caveman", "use caveman", "less tokens", "be brief", or invokes /caveman.

mattpocock/claude-handoff

Hand the current conversation off to a fresh background agent that picks up the work immediately.

mattpocock/codebase-design

Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.

mattpocock/design-an-interface

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

mattpocock/diagnose

Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument → fix → regression-test. Use when user says "diagnose this" / "debug this", reports a bug, says something is broken/throwing/failing, or describes a performance regression.

mattpocock/diagnosing-bugs

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.

mattpocock/edit-article

Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.

mattpocock/git-guardrails-claude-code

Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.

mattpocock/grilling

Grill the user relentlessly about a plan or design. Use when the user wants to stress-test a plan before building, or uses any 'grill' trigger phrases.

mattpocock/grill-me

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

mattpocock/grill-with-docs

Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.

mattpocock/handoff

Compact the current conversation into a handoff document for another agent to pick up.

mattpocock/implement

Implement a piece of work based on a PRD or set of issues.

mattpocock/implement-spec

Implement a specification in code.

mattpocock/improve-codebase-architecture

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

mattpocock/loop-me

Grill me about specs for the workflows I want to build, within this workspace.

mattpocock/migrate-to-shoehorn

Migrate test files from `as` type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace `as` in tests, or needs partial test data.

mattpocock/obsidian-vault

Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.

mattpocock/prototype

Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.

Verwandte Skills