Codebase Design skill

O que ela faz

A skill dá ao Claude um glossário fixo pra falar de estrutura de código: módulo, interface, profundidade, seam (o ponto onde dá pra trocar um comportamento sem editar ali), adapter, alavancagem e localidade. A regra é usar sempre as mesmas palavras, sem trocar por componente, serviço ou API, pra conversa não virar confusão.

O alvo são módulos fundos: muito comportamento atrás de uma interface pequena. Pra saber se um módulo se paga, o Claude faz o teste da exclusão: se apagar e a complexidade some, era só repasse; se ela reaparece espalhada em vários lugares, o módulo valia. Seam só entra quando há pelo menos duas versões atrás dele.

Pra teste, as regras são receber as dependências em vez de criá-las dentro, devolver resultado em vez de mexer em coisa de fora e manter poucos métodos. Os arquivos de apoio ensinam a juntar módulos rasos conforme o tipo de dependência e a desenhar a mesma interface de jeitos bem diferentes, com subagentes, pra comparar.

Nas palavras de quem fez

Quando usar

• O código virou um monte de funçõezinhas que só repassam dado pra outra
• Consertar um erro exige mexer em vários lugares ao mesmo tempo
• Deixar uma parte do sistema testável antes de mexer nela
• Decidir onde separar o código que fala com Stripe ou outro serviço de fora
• Organizar o projeto pro Claude achar as coisas mais rápido

Depois de instalar, é só pedir assim

• Olha o módulo de pagamentos e me diz onde dá pra deixar ele mais fundo
• Desenha a interface do módulo de envio de e-mail de três jeitos diferentes e compara
• Essa função de pedido cria a conexão com o Stripe dentro dela; reorganiza pra dar pra testar

Segurança

Gen Agent Trust Hub, Socket e Snyk leem o código da skill atrás de comando perigoso, dado vazando e instrução escondida. Alerta não é reprovação: quer dizer que vale ler o que a skill faz antes de instalar.

• Gen Agent Trust HubPassou
• SocketPassou
• SnykPassou

Perguntas