Por que a maioria das falhas no pipeline do Claude se deve aos prompts, não aos modelos — e como corrigir com habilidades

Uma postagem recente no r/ClaudeAI identifica um padrão comum: um prompt funciona isoladamente, mas quando colocado em um pipeline, produz silenciosamente resultados errados semanas depois. A causa raiz não é o modelo — é que o prompt assumia formatos de entrada não documentados e retornava estruturas que apenas um chamador sabia interpretar. A postagem argumenta que uma habilidade — ao contrário de um prompt bruto — impõe três coisas que previnem essa classe de falhas.

Contrato de Entrada

Defina exatamente quais campos o prompt precisa, o que acontece se um estiver faltando e qual é a entrada mínima viável. A postagem diz que isso leva dez minutos para escrever e previne falhas que surgiriam às 2 da manhã.

Esquema de Saída

Especifique precisamente o formato de retorno, incluindo estados de falha. Exemplo da postagem:

sucesso = {ação: string, confiança: float, justificativa: string}
falha = {ação: "pular", motivo: string}

"Retorna um resumo" não é um esquema. O esquema torna tanto o sucesso quanto a falha visíveis para os nós downstream.

Arquivo de Aprendizados

Mantenha um arquivo que registra no que a habilidade falhou, quais casos de borda foram encontrados e o que quebrou em produção. Ele é preenchido ao longo do tempo — toda vez que a habilidade te queima, a dor vai para lá, em vez de ser redescoberta por quem a executar em seguida.

O autor da postagem resume: "O prompt sozinho é v0. A habilidade é o que você promove para v1."