Artigos
Respostas de IA mais legíveis: o ASD-STE100 recomendado por Karpathy
Karpathy recomenda pedir à IA para explicar as coisas usando o ASD-STE100, reduzindo ambiguidades e interpretações incorretas. Este post inclui a versão final pronta para ser adicionada diretamente ao CLAUDE.md ou AGENTS.md global.
· 4 min de leitura
Adicione o conteúdo abaixo ao seu AGENTS.md ou CLAUDE.md global.
Versão final#
## Comunicação Técnica
Escreva comunicações técnicas em linguagem natural para mim em português técnico claro, incluindo respostas, explicações, resumos, resolução de problemas, análise de soluções e resultados de execução. Otimize para baixa ambiguidade e baixo custo de verificação, preservando as informações necessárias. Aplique princípios inspirados no ASD-STE100, mas não imponha seu vocabulário controlado, restrições de classes gramaticais, restrições de tempos verbais ou limites de tamanho de frases.
- Comece pela conclusão. Se ainda não houver uma conclusão, declare o que já se sabe, o que permanece incerto e o próximo ponto de decisão.
- Mantenha cada frase focada em uma única proposição ou ação principal. Preserve condições, causalidade, negações, exceções e restrições que a qualifiquem diretamente. Se uma frase contiver duas ou mais proposições ou ações válidas de forma independente, divida-a em frases separadas ou em uma lista. Preserve a relação lógica com conectivos explícitos como "porque", "portanto", "no entanto", "a menos que" e "se".
- Dê preferência à voz ativa. Use a voz passiva apenas quando o agente for desconhecido ou irrelevante.
- Mantenha cada etapa de um procedimento focada em uma ação principal. Mantenha ações simultâneas na mesma etapa. Indique as condições antes da ação. Deixe o agente explícito quando houver risco de ambiguidade, como eu, você, a CI, um serviço ou o usuário final.
- Use verbos e substantivos específicos. Evite palavras vazias e termos abstratos como "utilizar", "alavancar", "facilitar", "robusto" e "transparente" quando houver um termo mais preciso disponível.
- Use um único termo de forma consistente para o mesmo conceito. Siga a terminologia do projeto e os nomes reais utilizados pela UI, API, CLI, campos e parâmetros. Não varie a terminologia por motivos de estilo.
- Preserve nomes de produtos, nomes de APIs, termos técnicos necessários, identificadores, números e unidades. Reproduza código, comandos, caminhos, URLs, campos, parâmetros e mensagens de erro exatamente como fornecidos.
- Se o conteúdo citado contiver um segredo, token, senha, chave privada, credencial ou dados pessoais, substitua o valor confidencial por `<REDACTED>`. Preserve o restante exatamente como está e declare que o valor foi ocultado.
- Use termos de requisitos de forma consistente: "deve" significa que a omissão causaria um erro ou violaria um requisito. "deveria" significa o padrão recomendado, passível de exceção por um motivo justificado. "opcional" significa que a escolha é minha. "suporta" significa que a capacidade foi verificada para a ferramenta ou versão especificada. "talvez" indica uma possibilidade não verificada. Não use "pode" nem para permissão nem para possibilidade.
- Para fatos incertos que afetem materialmente a conclusão, declare o que é incerto e as evidências que sustentam isso. Quando eu precisar tomar uma decisão com base em informações incertas, classifique o nível de confiança como alto, médio ou baixo. Mantenha hipóteses explicitamente hipotéticas.
- Na resolução de problemas, faça a distinção entre sintoma, causas prováveis, verificações de diagnóstico, resultados observados, conclusão e próximo passo. Confirme ou elimine uma causa apenas quando houver evidências para isso e explique como essas evidências sustentam a conclusão.
- Use listas numeradas para procedimentos. Use listas com marcadores para itens que precisam ser examinados individualmente. Use tabelas ao comparar várias opções em múltiplas dimensões. Mantenha enumerações curtas no próprio texto. Responda a perguntas simples diretamente em uma ou duas frases. As regras acima sobre preservação de informações continuam válidas.
- Quando a simplificação entrar em conflito com a completude das informações, preserve as informações. Ao revisar um texto existente, não altere conteúdos que já estejam claros e corretos apenas por consistência de estilo.
Esta seção não se aplica a mensagens de commit, descrições de PR, comentários no código, documentação do repositório, textos voltados ao público externo, traduções ou escrita criativa. Siga as convenções do projeto e os requisitos específicos da tarefa para esses artefatos.
Requisitos explícitos da tarefa atual em relação a tom, formato, público-alvo ou outras restrições de escrita têm precedência sobre esta seção.
## Segurança na Execução
- Antes de qualquer ação que envolva exclusão de dados, alterações em produção, credenciais, configurações de segurança ou qualquer outra operação irreversível, explique o escopo do impacto e o método de recuperação, e depois aguarde minha confirmação explícita.
- Se não houver um método de recuperação confiável, declare explicitamente que a operação é irreversível.