landing-check — o trabalho aterrissou e as afirmações são verdadeiras?
Três perguntas que nada mais na cadeia de ferramentas faz. /code-review lê o diff para verificar a correção. /audit varre todo o projeto, frio. coding-conventions faz o autor reexecutar seu próprio código. Todos os três podem ser aprovados enquanto a alteração foi para um arquivo que nada executa, o relatório afirma um número errado e metade das cópias nunca foi tocada.
A classe de falha para a qual isto existe, observada na prática: uma correção de segurança foi implantada iterando sobre cada arquivo .git/hooks/pre-commit em um conjunto de repositórios. Mas vários desses repositórios definem core.hooksPath, e o git então ignora .git/hooks completamente — então, em alguns deles, a correção pousou em um arquivo morto enquanto o hook ativo mantinha o caminho antigo. O loop confirmou cada gravação, e o relatório afirmou que a correção era universal por seis dias. O diff estava correto. A verificação era real. Ambos estavam sobre o arquivo errado.
Cada verificação abaixo é uma que uma execução real precisou. Nenhuma é especulativa — veja Procedência no final. Dez execuções depois: a varredura encontrou zero bugs de código e aproximadamente quarenta afirmações falsas, correções mal posicionadas, guardas mortos e correções que não se propagaram. Essa é a forma do que ela captura.
Gatilho
/landing-check, ou: "did that land", "sweep the changes", "verify what I just did", "check my work before I commit". Invocado apenas — custa um agente, então nunca dispara por conta própria.
Não é este skill
- Correção do código no diff →
/code-review(nativo; tem multi-agente e--fix). Não reavalie lógica aqui. - Varredura de todo o projeto →
/audit(frio, caro). - Reexecutar o que você acabou de escrever →
coding-conventions(mesmo contexto, olhos do autor, dispara a partir do hook PostToolUse). Se um achado pertence a um desses, nomeie-o e passe adiante — não faça este skill crescer para englobá-los.
Como executar
Crie UM agente novo (ferramenta Agent, propósito geral). Contexto moderado: isso é limitado ao que mudou, não ao projeto.
O que o agente recebe — apenas artefatos:
- os caminhos de repositório tocados e uma linha sobre o que é o projeto;
git status+git diff(egit diff --statpor repositório) — ou, para árvores que não são repositórios, a lista de caminhos modificados nesta sessão;- o relato ESCRITO do trabalho: mensagens de commit, o registro no log, o texto do relatório final, qualquer documento editado para descrever a alteração;
- quais das árvores tocadas são PÚBLICAS (enviadas para qualquer lugar), se houver;
- passos 1–3 e o formato de saída abaixo, e a instrução para marcar qualquer coisa que não alcance como NÃO VARRIDO.
O que ele NÃO DEVE receber: sua conta do que você fez. As afirmações são o espécime. Se você entregar ao agente seu resumo, você entrega a ele o mesmo ponto cego que produziu o erro — você se torna réu e testemunha. Ele re-deriva cada afirmação dos artefatos escritos e do disco. Esta é a única regra que faz o skill valer seu custo; quebre-a e isso se torna autoavaliação em uma segunda janela.
O agente relê o estado ao vivo. git status, ahead/behind, o que foi enviado: derivado no momento da varredura, não da captura que recebeu — outras sessões cometem, enviam e editam no meio tempo (uma sessão concorrente cometeu uma correção dentro de um commit não relacionado; seis repositórios foram enviados minutos antes de uma varredura que foi informada de "zero envios"). ahead N não prova nada sem um fetch primeiro — pergunte ao remoto (git ls-remote, depois rev-list --left-right --count @{u}...HEAD).
1. ATERRISSAGEM — a edição alcançou o arquivo que executa?
Para cada arquivo alterado, pergunte se existe outra cópia e se algo escolhe entre elas. A assinatura é: o arquivo editado e o arquivo executado têm o mesmo nome e caminhos diferentes.
- Sombreamento:
git config core.hooksPath(definido ⇒.git/hooks/*é código morto; resolva comgit rev-parse --git-path hooks/<nome>, o resolvedor que o próprio git usa), ordemPATHpara scripts, symlinks, cópias fornecidas sobnode_modules, uma cópia venv vs. uma cópia do repositório. - Sistemas multi-árvore: se um arquivo existe em mais de uma árvore (instalado / laboratório / público, dev / dist, src / build), qual delas o runtime carrega? O alterado era ela?
- Registro: se a alteração adiciona ou edita algo que precisa ser conectado (um hook, uma tarefa agendada, uma rota, um ponto de entrada), leia o arquivo de registro e confirme que o caminho lá resolve para o arquivo que você alterou.
- Ativação — o arquivo certo é necessário, não suficiente. Para qualquer coisa que seja um controle — uma guarda, regra de negação, correspondente de hook, regex, padrão de permissão, asserção canário, regra de ignorar — plante o positivo que ele existe para capturar e observe-o disparar, depois um negativo e observe-o ficar quieto. Um controle nunca observado disparando é NÃO VERIFICADO. Controles que parecem proteção e não puderam disparar, todos encontrados por execuções: regras de negação que eram correspondentes de prefixo e nunca poderiam bloquear um token no meio do comando; um regex de vazamento cujo
\Rcompilou paraX:Repoe não pôde corresponder a um caminho real; um filtro de nome sensível a maiúsculas/minúsculas que deixou passar uma grafia toda em maiúsculas; uma asserção/findings/.test(src)que era verdadeira para sempre. - Veredito por arquivo alterado: ATERRIZADO / MAL-ATERRIZADO / NÃO VERIFICÁVEL (diga por quê). Um arquivo cuja cópia em execução você não pôde determinar é NÃO VERIFICÁVEL, não ATERRIZADO. Uma cópia morta deixada para trás não é em si um achado — diga qual cópia está viva e que a edição está nela.
2. AFIRMAÇÕES — o relato escrito corresponde ao disco?
Extraia cada afirmação verificável dos artefatos, depois re-derive cada uma de forma independente — um comando diferente daquele que a produziu, onde um diferente exista. Ordem de prioridade, maior rendimento primeiro:
- Universais — "todos os 7", "cada cópia", "byte-idêntico", "nenhum permanece", "0 achados", "nada vazou por todos os 17 repositórios". Uma falta falsifica toda a declaração, e esta é a classe que produziu o erro 08-05. Enumere o conjunto completo e verifique cada membro; nunca aceite uma verificação por amostragem como prova de um universal. Um universal que você só pôde verificar por amostragem é NÃO VERIFICADO.
- Contagens — "17 regras", "29 skills", "21/21". Conte a partir da fonte da verdade, não da frase. Observe o tempo verbal: uma contagem de entradas de registro escritas dentro da entrada que está sendo contada está errada por um no momento em que pousa; uma afirmação "os únicos arquivos sujos restantes" feita de dentro de um arquivo sujo é auto-falsificadora; uma citação de uma entrada que ainda não existe aponta para nada até que seja escrita.
- Estados — "passa", "limpo", "regenerado", "enviado". Execute-o, ou leia o artefato que o prova. Saída citada é uma afirmação sobre o programa: se um artefato cita uma linha de saída de ferramenta como evidência, grep a ferramenta por esse literal — uma linha impressa apenas no ramo de falha não pode evidenciar um passe, e uma linha que o programa nunca emite é uma citação fabricada.
- Números — um valor com mais dígitos significativos do que a saída de onde se origina é inventado (13 contagens de compartilhamento publicadas com 4 casas decimais de uma tabela de 2 casas decimais: 12 erradas). Uma estatística de um corpus VIVO (transcrições, logs, um registro crescente) não é reproduzível sem o estado do corpus fixado (contagem de arquivos + timestamp); reporte-a como NÃO VERIFICADA COMO AFIRMADA e nomeie o que reproduz. Verifique a aritmética dentro de uma frase ("27 mais 3 … 29 hoje"). Para comparações: mesmo conjunto de amostras em todos os braços, estimador nomeado, n informado — um 2×2 cujos braços não compartilham lotes não é uma comparação. Um campo ausente não é
false. Um==em um float que faz ida e volta através de float32 nunca correspondeu, e o JSON commitado continha0.0para um verdadeiro0.605. - Contradição interna — uma frase falsificada pela ressalva de seu próprio parágrafo cinco linhas depois; uma afirmação e sua refutação ambas presentes sem uma marcação datada; o mesmo valor citado três vezes e errado em todas as três.
Uma afirmação que você não pode verificar é reportada como NÃO VERIFICADA, nunca como verdadeira. Uma afirmação que é verdadeira mas por uma razão diferente da declarada é um achado.
3. COLATERAL — o que deveria ter se movido e não se moveu?
O diff mostra o que mudou. Isso pergunta o que a mudança obrigou e deixou por fazer. Execute o inverso do diff: para cada valor ou conceito alterado, grep na árvore por outros lugares que ainda afirmam o antigo.
- Cópias irmãs — todos os outros repositórios/ramos/pacotes que contêm o mesmo arquivo. A correção para um mal-aterrissamento ela mesma mal-aterrissou em uma de duas cópias; uma cópia total de um arquivo privado sobre seu gêmeo público reintroduziu o que um commit anterior removeu deliberadamente — compare a cópia pública com seu próprio
git show HEAD:, não com a fonte privada. - Propagação de correção — se o trabalho corrige uma afirmação, encontre toda outra cópia da AFIRMAÇÃO ANTIGA: HANDOFF, PRD, bins de memória, README, comentários de código, o gêmeo público, a própria descrição do skill. "Corrigido no registro, deixou HANDOFF e o bin declarando os números antigos" e "a terceira cópia desta afirmação ainda estava sem remoção" são o achado mais repetido de todas as execuções.
- Documentos citando o valor alterado — READMEs, descrições de skills, HANDOFF, PRD, comentários, pins
DEVE imprimir N/N. Uma contagem alterada no código e inalterada na prosa é um achado. - Vazamento de publicação — aterrissado onde NÃO DEVE. Se alguma árvore tocada é pública: varra seu diff (e os arquivos que tocou, contra
HEAD) por identificadores privados — nomes, emails, caminhos absolutos, nomes de projetos privados — insensível a maiúsculas/minúsculas. Diga se esta alteração introduziu a string ou a herdou; as duas precisam de correções diferentes e o autor já chamou a primeira de segunda antes. - Gêmeos gerados — HTML renderizado de um registro, linhas de TOC, bins de memória, âncoras: regenerados? Uma âncora que resolve mas pousa um título antes não é "quebrada", então
broken: 0não a prova. - Novos tipos de artefato — o trabalho criou um tipo de arquivo que não existia antes (diretórios de cache, saída de build, logs)? Existe uma regra de ignorar, e ela está no repositório certo?
- Subprodutos — arquivos criados e deixados para trás: arquivos não rastreados, diretórios temporários,
__pycache__,.tmp, backups. Liste-os com caminhos completos; não delete nada. - A obrigação que os documentos declaram — se as próprias regras do projeto dizem que uma alteração deste tipo requer algo (uma entrada de registro, um gêmeo regenerado, um snapshot sincronizado, uma execução de teste, um incremento de pin), verifique se isso aconteceu.
Sonda — a metade mecânica, executada antes do agente julgar
landing-probe.js (Node portátil, zero dependências, somente leitura) enumera o que os passos 1–3 de outra forma re-derivariam manualmente, então o agente lê um censo em vez de adivinhar um. Forneça a ele cada árvore tocada; entregue sua saída ao agente como um artefato.
node landing-probe.js probe <root>... [--file <p>]... [--since <min>]
[--settings <json>] [--remote] [--all]
node landing-probe.js --canary
HOOK— por repositório, por hook: o arquivo que o git EXECUTARÁ (git rev-parse --git-path, honracore.hooksPath) e qualquer cópia MORTA no outro lugar; um caminho registrado sem arquivo éAUSENTE.CHANGED— staged / modificado / não rastreado por repositório;--filenomeia arquivos fora de qualquer repositório;--since Nadiciona arquivos modificados nos últimos N minutos sob raízes NÃO-repositório (uma árvore instalada não é um repositório).TWIN— para cada arquivo alterado, todo arquivo de mesmo nome sob qualquer raiz,IGUALouDIFERENTE(sha256, normalizado CRLF). Nomes convencionais (SKILL.md,README.md— qualquer nome base com mais de 6 cópias) combinam em nome-do-diretório-pai/nome, não apenas nome.--alllista cada grupo gêmeo, não apenas os alterados.REG—--settings <json>: toda string em forma de caminho (após expansão~/$HOME/%USERPROFILE%) e se elaRESOLVE.REMOTE— ahead/behind por repositório, rotuladoref EM CACHEa menos que--remotetenha buscado primeiro.ahead Nde uma ref em cache não prova nada.
Saia 1 quando houver algo para olhar (um hook MORTO, um gêmeo DIFERENTE de um arquivo alterado, um registro AUSENTE); 0 para um censo limpo. Não julga nada — DIFERENTE entre um privado e sua cópia pública generalizada é esperado, e o agente o informa. --canary constrói repositórios descartáveis (hooksPath definido / não definido / apontando para nada, um remoto bare e um clone um commit à frente, gêmeos CRLF, uma floresta de nomes convencionais, um arquivo de configurações com um caminho ausente) e DEVE imprimir CANARY PASS 23/23 antes que você confie em um censo.
Saída
Curta. Esta é uma varredura de sanidade pré-commit, não um relatório de auditoria.
- Linha de veredito: SEGURO PARA COMMITAR / CORRIJA PRIMEIRO / NÃO VERIFICÁVEL, uma frase.
- Linha de cobertura: quais artefatos foram lidos, quais árvores foram varridas, e o que foi NÃO VARRIDO — um relatório curto nunca deve parecer um relatório limpo.
- Tabela de aterrissagem:
arquivo | cópias encontradas | qual delas executa | disparou em um positivo plantado? | veredito. Apenas linhas que são MAL-ATERRIZADO ou NÃO VERIFICÁVEL precisam de detalhe. - Tabela de afirmações:
afirmação (citada) | artefato fonte | resultado re-derivado | VERDADEIRO / FALSO / NÃO VERIFICADO. - Lista de colaterais: o que deveria ter se movido e não se moveu, cada um com um caminho.
- Confirmado: os negativos de sustentação e os números que re-derivaram exatamente (nenhum mal-aterrissamento, nenhum vazamento, 25/25 reproduzidos) — uma varredura que relata apenas falhas não ensina nada sobre o que é sólido, e o registro do autor precisa delas.
- Passagens: qualquer coisa pertencente a
/code-review,/auditoucoding-conventions, nomeada e passada adiante em vez de meia-feita aqui.
Após o relatório
- Re-verifique cada achado manualmente antes de agir. As afirmações do verificador são afirmações: uma execução teve seus inteiros re-derivados errados porque o corpus havia crescido sob ela; os invariantes se mantiveram. Aceite o que reproduz.
- A correção está sujeita às mesmas três perguntas. Correções para achados CORRIJA PRIMEIRO vão para cada cópia e cada documento citando o valor antigo — a execução que corrigiu um mal-aterrissamento de uma-de-duas-cópias enviou a correção para uma de duas cópias.
- Escreva a entrada de registro a partir dos valores re-derivados, após a última execução de verificação, não antes dela: uma entrada escrita primeiro registra o estado que você esperava, e o registro somente-apêndice torna isso permanente.
Regras
- Apenas achados. Não modifique nada — o agente é somente leitura, exatamente como o probe.
- Se uma verificação não pode ser concluída (o arquivo sumiu, o repositório não existe mais, sem acesso remoto), reporte NÃO VERIFICÁVEL com o motivo exato. Não finja uma limitação como confirmação.
- Cite linhas e arquivos exatos sempre que reportar um achado. Afirmações de arremesso sem suporte não são achados.
- Uma fonte da verdade é a coisa real. Um arquivo de configuração que não resolve mais, um hook que git não executa, um remoto que responde um commit que o clone local não tem. Sempre cruze referências com o que o sistema faz, não com o que ele diz.