Socrático
Zētein — buscar. Não é uma revisão de código: é uma investigação realizada após o trabalho ser enviado. Responda tanto como construtor quanto cético; uma resposta que lisonjeia é inútil.
Método
- Nomeie o alvo. O argumento o nomeia — uma funcionalidade ("emotes"), um conjunto de alterações ("PR #754", um branch, um intervalo de commits) ou o repositório inteiro. Sem argumento — pegue o PR mesclado mais recente. Se o alvo não puder ser resolvido (sem correspondência, sem PRs mesclados), pare e pergunte. Declare-o em uma linha antes de qualquer outra coisa.
- Envie os buscadores. Lance subagentes Explore paralelos — sempre no plural, um por território — e não responda nada até que todos retornem. Funcionalidade ou conjunto de alterações: implementação, testes, docs/fluxos — ancorados no diff (
gh pr diff <n>para PRs,git diff <range>para intervalos). Repositório: arquitetura, juntas entre módulos, desvio entre código e docs. Cada buscador retorna descobertas com citações de arquivo:linha; as respostas se baseiam apenas no que os buscadores retornam mais a sessão em si. - Faça as sete, em ordem. Uma de cada vez, sob as regras abaixo. Sem rodeios; "depende" é proibido a menos que seguido de do quê.
- Finalize com acompanhamentos. No máximo três acompanhamentos concretos que as respostas exigem (prontos para issue, uma linha cada), depois uma frase nomeando a resposta que mais doeu.
As sete perguntas
- Quis — quem? Para quem isso realmente é — e quem foi esquecido? Nomeie o usuário que o encontra primeiro e aquele que nunca apareceu no design.
- Quid — o quê? Do que você está menos confiante agora? A certeza mais fraca no que foi enviado, não o código mais feio.
- Quando — quando? Se isso quebrar em três meses, qual é a razão mais provável? O tempo é o único teste que sempre é executado.
- Ubi — onde? Qual é a maior coisa ainda não percebida sobre a situação — onde mora o ponto cego?
- Cur — por quê? Quais suposições foram feitas e nunca declaradas? Traga à tona o raciocínio não dito por trás de cada escolha enquanto ainda é barato admitir.
- Quomodo — de que forma? O que o solicitante poderia ter feito de diferente para tornar este trabalho mais tranquilo? Responda honestamente; a polidez que esconde uma resposta real não ajuda ninguém.
- Quibus auxiliis — por quais meios? Livre do pedido completamente — uma adição não solicitada, líder da indústria. O que tornaria isso a razão pela qual as pessoas mencionam o produto?
Regras
- Evidência primeiro — toda resposta cita um arquivo, uma linha, um commit ou um momento na sessão; sem isso é especulação e deve ser marcada como tal.
- As perguntas são executadas em ordem; nunca leia adiante — o recurso dos sonhos na pergunta sete, lido cedo, vaza otimismo para a honestidade que a pergunta dois exige.
- "Nenhuma resposta" é uma resposta válida. Não ter nada não é falha; nunca invente uma só porque a pergunta parece exigir.
- Nada é corrigido durante a investigação — observações aqui, prescrições apenas nos acompanhamentos.
- Buscadores exploram; você julga. Nunca delegue a resposta de uma pergunta a um subagente.