domain-modeling
Construa Modelos de Domínio Precisos com Vocabulário Ativo
Projetos de software sofrem quando equipes usam terminologia inconsistente ou perdem o controle de por que decisões foram tomadas. Esta skill ajuda você a construir e aprimorar ativamente seu modelo de domínio, desafiando termos, inventando casos de borda e capturando decisões em CONTEXT.md e ADRs.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "domain-modeling". Usuário diz: 'Quando um cliente cancela seu pedido, precisamos reembolsar o pagamento.'
النتيجة المتوقعة:
Resposta: "Seu glossário define 'cancelamento' como encerrar um pedido antes do fulfillment, mas reembolso é um conceito de billing. Você está cancelando o pedido e disparando um evento de reembolso no Billing, ou o cancelamento em si é uma operação de billing? Vamos definir qual contexto é dono disso."
استخدام "domain-modeling". Usuário decide usar PostgreSQL para o modelo de escrita em um sistema event-sourced.
النتيجة المتوقعة:
Resposta: "Isso qualifica para um ADR — difícil de reverter (escolha de banco de dados), surpreendente sem contexto (por que Postgres em vez de um event store?), trade-off real (alternativas consideradas). Criando ADR-0003-postgres-para-modelo-de-escrita.md agora."
التدقيق الأمني
آمنThis skill contains only markdown documentation describing domain modeling practices, CONTEXT.md format, and ADR format. Static analysis flagged false positives: backtick matches are markdown inline code formatting, not shell execution; cryptographic matches are coincidental word fragments in documentation; system reconnaissance flags refer to file path references in examples, not actual filesystem access. No executable code, scripts, network calls, or malicious patterns were found.
عوامل الخطر
📁 الوصول إلى نظام الملفات (3)
درجة الجودة
ماذا يمكنك بناءه
Iniciando um novo modelo de domínio
Use ao começar um novo projeto para estabelecer o vocabulário inicial e documentar as principais escolhas arquiteturais antes que o código seja escrito.
Resolvendo conflitos de terminologia
Use durante discussões de equipe quando diferentes membros usam palavras diferentes para o mesmo conceito e clareza é necessária.
Documentando decisões arquiteturais
Use ao fazer escolhas tecnológicas significativas que desenvolvedores futuros precisarão entender, como seleção de banco de dados ou padrões de integração.
جرّب هذه الموجهات
Ajude-me a construir o modelo de domínio para este projeto. Comece lendo CONTEXT.md (se existir) e então desafie ativamente qualquer terminologia que eu usar enquanto discutimos o design.
Acabei de usar o termo "conta" em nossa discussão. Verifique CONTEXT.md e me diga se isso conflita com nosso vocabulário definido, então proponha o termo preciso que devemos usar.
Acabamos de definir a relação entre Pedido e Fatura. Crie 3 cenários de caso de borda que sondem o limite entre esses dois conceitos e nos forcem a ser precisos.
Acabamos de decidir usar event sourcing para o modelo de escrita. Verifique se isso atende aos três critérios de ADR (difícil de reverter, surpreendente sem contexto, trade-off real). Se sim, crie o ADR usando o formato de ADR-FORMAT.md.
أفضل الممارسات
- Crie CONTEXT.md e ADRs de forma preguiçosa — apenas quando tiver algo significativo para registrar
- Desafie cada termo ambíguo imediatamente em vez de deixar a confusão se acumular
- Mantenha as definições do CONTEXT.md em uma ou duas frases focadas no que o termo É
- Escreva ADRs apenas para decisões que são difíceis de reverter, surpreendentes sem contexto ou envolvem trade-offs reais
تجنب
- Tratar CONTEXT.md como uma especificação ou rascunho para detalhes de implementação
- Escrever ADRs para decisões óbvias que não têm alternativas reais
- Adicionar conceitos gerais de programação (timeouts, tipos de erro) ao glossário
- Acumular atualizações de terminologia em lote em vez de capturá-las inline conforme são resolvidas