codebase-design
Projete módulos profundos com interfaces claras
A maioria das bases de código sofre com módulos rasos com interfaces grandes e implementações finas. Esta skill fornece um vocabulário compartilhado e uma metodologia para projetar módulos profundos, decidir onde colocar as costuras e tornar o código mais testável e manutenível.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "codebase-design". Revise a função processOrder. Ela é um módulo profundo?
النتيجة المتوقعة:
- Atualmente é rasa: processOrder(order) cria seu próprio StripeGateway internamente.
- Versão profunda: processOrder(order, paymentGateway) aceita o gateway como dependência.
- Os chamadores podem substituir gateways de teste ou mock sem alterar a função.
- A interface ganha um parâmetro extra, mas o módulo se torna testável.
استخدام "codebase-design". Como devo classificar uma dependência de cache Redis?
النتيجة المتوقعة:
- Redis é local-substituível: ioredis-mock ou testcontainers-redis podem rodar em testes.
- Aprofundável se o substituto existir.
- Teste com o substituto rodando na suíte de testes.
- Sem porta na interface externa, apenas uma costura interna.
التدقيق الأمني
آمنThe codebase-design skill is a pure documentation skill providing vocabulary and methodology for designing deep modules. All 35 static findings are false positives: 'Weak cryptographic algorithm' detections are triggered by the word 'deep' (confused with DES cipher references in unrelated codebases), 'Ruby/shell backtick execution' matches markdown backtick formatting for code blocks, and 'System reconnaissance' is a misidentification of architectural vocabulary. No executable code, scripts, or data flows exist in any file.
عوامل الخطر
⚙️ الأوامر الخارجية (8)
درجة الجودة
ماذا يمكنك بناءه
Projetando a interface de um novo módulo
Um desenvolvedor deseja projetar uma interface limpa para uma nova funcionalidade, com máxima alavancagem para os chamadores e área de superfície mínima para testes.
Refatorando módulos rasos em módulos profundos
Uma equipe de engenharia acumulou módulos rasos com implementações finas e deseja consolidá-los em unidades mais profundas e testáveis.
Estabelecendo um vocabulário arquitetônico compartilhado
Uma equipe precisa de uma linguagem consistente para discutir limites de módulos, costuras e adaptadores em revisões de código e discussões de design.
جرّب هذه الموجهات
Revise a interface do [nome do módulo]. Ela é profunda ou rasa? Posso reduzir o número de métodos ou simplificar os parâmetros? Que complexidade poderia ser escondida dentro da implementação?
Observe estes [N] módulos rasos relacionados. Mesclá-los poderia criar um módulo mais profundo? Classifique suas dependências como in-process, local-substituível, remoto-mas-próprio ou externa verdadeira.
Preciso decidir onde a costura deve ficar para [funcionalidade]. Aplique o teste de exclusão: se eu apagar este módulo, a complexidade desaparece ou se espalha? Deve haver uma porta ou apenas uma costura interna?
Inicie 3 subagentes para projetar interfaces radicalmente diferentes para [módulo]. O Agente 1 deve minimizar a interface, o Agente 2 deve maximizar a flexibilidade e o Agente 3 deve otimizar para o chamador mais comum.
أفضل الممارسات
- Use o vocabulário exato desta skill de forma consistente em sua equipe e documentação
- Aplique o teste de exclusão para verificar se um módulo está cumprindo seu papel
- Introduza uma porta somente quando pelo menos dois adaptadores forem justificados
- Escreva testes na interface do módulo, não além dela
- Projete para dois adaptadores (produção e teste) antes de adicionar mais
تجنب
- Substituir 'componente', 'serviço', 'API' ou 'boundary' pelos termos precisos desta skill
- Introduzir costuras com apenas um adaptador
- Testar além da interface, acessando estado interno
- Tratar profundidade como uma razão entre linhas de implementação e linhas de interface
- Manter testes unitários antigos em módulos rasos após a consolidação