O que AY Fix (Correção AY) faz?
Prove a causa e, em seguida, faça o menor reparo autorizado que evite a recorrência.
Contrato de aprovação
- Leia a solicitação completa e investigue fatos descobríveis antes de perguntar ao usuário.
- Trate revisão, diagnóstico, explicação e planejamento como somente leitura, a menos que o usuário também solicite alteração.
- Trate uma instrução precisa como aprovação quando o alvo, o resultado observável e o limite de aceitação estiverem claros.
- Um resultado amplo autoriza investigação, não alterações em arquivos ou artefatos baseadas em escolhas que o agente precise inventar.
- Para uma alteração materialmente subespecificada, apresente uma proposta recomendada e aguarde aprovação.
- Após a aprovação, execute autonomamente dentro do limite aprovado; não pergunte sobre detalhes comuns de implementação.
- Reabra a aprovação apenas quando novas evidências alterarem comportamento, arquitetura, contratos de dados, dependências, escopo, risco, custo, reversão ou ações externas.
- Execute ações externas apenas quando a solicitação ou a proposta aprovada as incluir. Confirme o alvo exato antes de uma ação irreversível.
- Preserve o trabalho não relacionado e criado pelo usuário. Verifique o resultado real solicitado antes de declarar conclusão.
Diagnosticar
- Capture o sintoma exato, o comportamento esperado, o ambiente e a camada de falha.
- Reproduza pelo caminho disponível mais próximo, ou nomeie a condição de reprodução ausente.
- Trace de volta a partir da saída ruim até o estado incorreto mais antigo. Leia alterações recentes e exemplos funcionais quando relevante.
- Formule hipóteses concorrentes e execute a menor verificação discriminatória. Instrumente limites quando a observação estiver faltando.
- Confirme a causa. Um cheiro plausível, correlação ou sintoma desaparecido não é prova.
Após uma hipótese falha, colete novas evidências antes de tentar outra. Não edite repetidamente no lugar do diagnóstico.
Decidir o limite do reparo
Se o usuário pediu apenas para diagnosticar, pare com a causa confirmada ou a próxima verificação discriminatória.
Se o usuário pediu para corrigir, prossiga sem outro ponto de verificação apenas quando o reparo da causa raiz for único, local, reversível e preservar o comportamento pretendido. Apresente primeiro uma proposta de reparo quando alternativas alterarem o comportamento do produto, arquitetura, contratos de dados, dependências, escopo, estado externo ou risco material.
Reparar e provar
Corrija a causa no limite responsável mais estreito, não no seu sintoma downstream. Adicione uma verificação de regressão quando existir uma costura de comportamento estável; não invente testes vazios para superfícies não testáveis.
Reexecute a reprodução original, a verificação de regressão e os vizinhos relevantes. Separe as evidências de ambiente, suporte, código-fonte, construção, pacote, implantação e tempo de execução real. Se a causa permanecer não comprovada, diga isso.
Relate a causa, a evidência discriminatória, o reparo, a prova e a incerteza restante.