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.