Pular para conteúdo

skill codebase-design — módulo profundo

Roda em model/effort Dispara quando
agente-reach inherit / high desenhar interface de módulo, decidir onde passa a costura

Vocabulário compartilhado pra desenhar módulos profundos: interface pequena escondendo implementação grande, em vez de módulo raso que só repassa chamada.

Cobre glossário, o corte profundo × raso, princípios, desenho para testabilidade e as relações entre módulos — e declara também os enquadramentos que rejeita, o que evita rediscutir a mesma preferência a cada PR.

É a skill que outras consultam quando precisam do vocabulário: skill-ddd pra camada, skill-improve-codebase-architecture pra caçar oportunidade no código que já existe.

Testabilidade não é consequência, é critério de desenho. Módulo difícil de testar quase sempre é módulo com fronteira no lugar errado — e é mais barato mover a fronteira que escrever mock pra sustentar a errada.