mattpocock/domain-modeling

Construire et affiner le modèle domaine d'un projet. À utiliser lorsque l'utilisateur souhaite préciser la terminologie du domaine ou un langage ubiquitaire, enregistrer une décision architecturale, ou lorsqu'une autre compétence doit maintenir le modèle domaine.

Qu'est-ce que domain-modeling ?

Cette compétence est dédiée à la construction et à l'affûtage actif du modèle domaine d'un projet logiciel. Elle va bien au-delà de la simple lecture d'un fichier de glossaire : c'est une discipline active qui consiste à challenger les termes, inventer des scénarios aux limites, et écrire le glossaire et les décisions au moment où ils se cristallisent. Le skill s'applique lorsque l'utilisateur a besoin de préciser la terminologie du domaine (langage ubiquitaire), d'enregistrer une décision architecturale (ADR), ou lorsqu'une autre compétence doit maintenir ce modèle. Il gère une structure de fichiers standardisée (CONTEXT.md pour le glossaire, docs/adr/ pour les décisions, et éventuellement un CONTEXT-MAP.md pour les projets multi-contextes). Pendant une session, il challenge les termes contradictoires, affine le langage flou, discute des scénarios concrets pour tester les relations, croise les informations avec le code, et met à jour le glossaire en temps réel. Les ADR (Architecture Decision Records) ne sont proposés que lorsqu'ils répondent à trois critères stricts : difficile à annuler, surprenant sans contexte, et issu d'un véritable compromis.

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

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Modélisation du Domaine

Construisez et affûtez activement le modèle domaine du projet pendant que vous concevez. Il s'agit d'une discipline active — challenger les termes, inventer des scénarios aux limites, et écrire le glossaire et les décisions au moment où ils se cristallisent. (Le simple fait de lire CONTEXT.md pour le vocabulaire n'est pas cette compétence — c'est une habitude qu'une ligne de code peut accomplir. Cette compétence est pour quand vous modifiez le modèle, pas seulement quand vous le consommez.)

Structure des fichiers

La plupart des dépôts ont un seul contexte :

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

Si un fichier CONTEXT-MAP.md existe à la racine, le dépôt a plusieurs contextes. La carte indique où se trouve chacun d'eux :

/
├── CONTEXT-MAP.md
├── docs/
│   └── adr/                          ← décisions à l'échelle du système
├── src/
│   ├── ordering/
│   │   ├── CONTEXT.md
│   │   └── docs/adr/                 ← décisions spécifiques au contexte
│   └── billing/
│       ├── CONTEXT.md
│       └── docs/adr/

Créez les fichiers de manière paresseuse — seulement lorsque vous avez quelque chose à écrire. Si aucun CONTEXT.md n'existe, créez-en un dès que le premier terme est résolu. Si aucun docs/adr/ n'existe, créez-le dès qu'une première ADR est nécessaire.

Pendant la session

Challenger le glossaire

Lorsque l'utilisateur utilise un terme qui entre en conflit avec le langage existant dans CONTEXT.md, signalez-le immédiatement. "Votre glossaire définit 'annulation' comme X, mais vous semblez vouloir dire Y — lequel est-ce ?"

Affiner le langage flou

Lorsque l'utilisateur utilise des termes vagues ou surchargés, proposez un terme canonique précis. "Vous dites 'compte' — voulez-vous dire le Client ou l'Utilisateur ? Ce sont des choses différentes."

Discuter de scénarios concrets

Lorsque les relations du domaine sont discutées, testez-les avec des scénarios spécifiques. Inventez des scénarios qui sondent les cas limites et forcent l'utilisateur à être précis sur les frontières entre les concepts.

Recouper avec le code

Lorsque l'utilisateur énonce comment quelque chose fonctionne, vérifiez si le code est d'accord. Si vous trouvez une contradiction, signalez-la : "Votre code annule des commandes entières, mais vous venez de dire qu'une annulation partielle est possible — lequel est correct ?"

Mettre à jour CONTEXT.md en ligne

Lorsqu'un terme est résolu, mettez à jour CONTEXT.md immédiatement. Ne les regroupez pas — capturez-les au fur et à mesure. Utilisez le format dans CONTEXT-FORMAT.md.

CONTEXT.md doit être totalement dépourvu de détails d'implémentation. Ne traitez pas CONTEXT.md comme un cahier des charges, un bloc-notes ou un dépôt pour les décisions d'implémentation. C'est un glossaire et rien d'autre.

Proposer des ADR avec parcimonie

Proposez de créer une ADR uniquement lorsque les trois conditions suivantes sont remplies :

  1. Difficile à annuler — le coût d'un changement d'avis ultérieur est important
  2. Surprenant sans contexte — un futur lecteur se demandera "pourquoi ont-ils fait comme ça ?"
  3. Résultat d'un véritable compromis — il y avait de véritables alternatives et vous en avez choisi une pour des raisons spécifiques

Si l'une des trois conditions manque, ne créez pas d'ADR. Utilisez le format dans 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.

Skills associés