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:
- Difícil de reverter — o custo de mudar de ideia depois é significativo
- Surpreendente sem contexto — um leitor futuro vai se perguntar "por que eles fizeram assim?"
- 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.