Improve Codebase Architecture

Traga à tona fricção arquitetural e proponha deepening opportunities — refactors que transformam shallow modules em deep modules. O alvo é testability e AI-navigability.

Glossário

Use estes termos exatamente em cada sugestão. Linguagem consistente é o ponto — não derive para "component", "service", "API" ou "boundary". Definições completas em LANGUAGE.md.

• Module — qualquer coisa com interface e implementação (função, classe, pacote, slice).
• Interface — tudo que um caller precisa saber para usar o module: tipos, invariantes, error modes, ordering, config. Não só a type signature.
• Implementation — o código por dentro.
• Depth — leverage na interface: muito comportamento atrás de uma interface pequena. Deep = high leverage. Shallow = interface quase tão complexa quanto a implementação.
• Seam — onde uma interface vive; um lugar onde comportamento pode ser alterado sem editar inline. (Use isto, não "boundary".)
• Adapter — coisa concreta que satisfaz uma interface num seam.
• Leverage — o que callers ganham de depth.
• Locality — o que mantenedores ganham de depth: change, bugs, knowledge concentrados num lugar só.

Princípios-chave (veja LANGUAGE.md para a lista completa):