mattpocock/modelagem-de-dominio

Constrói e refina o modelo de domínio de um projeto. Use quando o usuário quiser definir a terminologia do domínio ou uma linguagem ubíqua, registrar uma decisão arquitetural, ou quando outra habilidade precisar manter o modelo de domínio.

O que é modelagem-de-dominio?

Esta skill capacita o agente a ativamente construir e refinar o modelo de domínio de um projeto de software. Diferente de simplesmente consumir um glossário existente, esta skill se concentra em desafiar termos, inventar cenários de borda e registrar decisões no momento em que cristalizam. Ela é útil para projetos que buscam estabelecer uma linguagem ubíqua (Domain-Driven Design) e manter um registro claro de termos e decisões arquiteturais. A skill suporta repositórios com um único contexto (arquivo CONTEXT.md) ou múltiplos contextos (usando CONTEXT-MAP.md). Durante a sessão, ela desafia terminologia conflitante, afina linguagem vaga, discute cenários concretos, cruza referências com o código e atualiza o CONTEXT.md inline. Oferece ADRs (Architecture Decision Records) apenas quando a decisão é difícil de reverter, surpreendente sem contexto e resultado de uma troca real.

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

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Modelagem de Domínio

Construa e refine ativamente o modelo de domínio do projeto enquanto você projeta. Esta é a disciplina ativa — desafiar termos, inventar cenários de borda e escrever o glossário e as decisões no momento em que cristalizam. (Apenas ler o CONTEXT.md em busca de vocabulário não é esta skill — isso é um hábito de uma linha que qualquer skill pode fazer. Esta skill é para quando você está alterando o modelo, não apenas consumindo-o.)

Estrutura de arquivos

A maioria dos repositórios tem um único contexto:

/
├── CONTEXT.md
├── docs/
│   └── adr/
│       ├── 0001-pedidos-orientados-a-eventos.md
│       └── 0002-postgres-para-modelo-de-escrita.md
└── src/

Se um CONTEXT-MAP.md existir na raiz, o repositório tem múltiplos contextos. O mapa aponta para onde cada um reside:

/
├── CONTEXT-MAP.md
├── docs/
│   └── adr/                          ← decisões do sistema todo
├── src/
│   ├── ordering/
│   │   ├── CONTEXT.md
│   │   └── docs/adr/                 ← decisões específicas do contexto
│   └── billing/
│       ├── CONTEXT.md
│       └── docs/adr/

Crie arquivos de forma preguiçosa — apenas quando você tiver algo para escrever. Se nenhum CONTEXT.md existir, crie um quando o primeiro termo for resolvido. Se nenhum docs/adr/ existir, crie-o quando o primeiro ADR for necessário.

Durante a sessão

Desafie o glossário

Quando o usuário usar um termo que conflita com a linguagem existente no CONTEXT.md, aponte isso imediatamente. "Seu glossário define 'cancelamento' como X, mas você parece estar usando Y — qual é o correto?"

Afine linguagem vaga

Quando o usuário usar termos vagos ou sobrecarregados, proponha um termo canônico preciso. "Você está dizendo 'conta' — você quer dizer o Cliente ou o Usuário? Essas são coisas diferentes."

Discuta cenários concretos

Quando relações de domínio estiverem sendo discutidas, teste-as com cenários específicos. Invente cenários que explorem casos de borda e forcem o usuário a ser preciso sobre os limites entre conceitos.

Cruze referência com o código

Quando o usuário afirmar como algo funciona, verifique se o código concorda. Se encontrar uma contradição, traga-a à tona: "Seu código cancela Pedidos inteiros, mas você acabou de dizer que cancelamento parcial é possível — qual está certo?"

Atualize CONTEXT.md inline

Quando um termo for resolvido, atualize o CONTEXT.md ali mesmo. Não agrupe essas atualizações — capture-as conforme acontecem. Use o formato em CONTEXT-FORMAT.md.

O CONTEXT.md deve ser totalmente desprovido de detalhes de implementação. Não trate o CONTEXT.md como uma especificação, um bloco de rascunho ou um repositório para decisões de implementação. É um glossário e nada mais.

Ofereça ADRs com moderação

Ofereça-se para criar um ADR apenas quando todas as três condições forem verdadeiras:

  1. Difícil de reverter — o custo de mudar de ideia depois é significativo
  2. Surpreendente sem contexto — um leitor futuro vai se perguntar "por que eles fizeram assim?"
  3. Resultado de uma troca real — havia alternativas genuínas e você escolheu uma por razões específicas

Se qualquer uma das três estiver faltando, pule o ADR. Use o formato em 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.

Habilidades Relacionadas