Communitygithub.com

Evan-Daruwalla/claude-skill-suite

Varredura pós-trabalho por um agente FRESH: a alteração chegou ao local onde é executada, as afirmações correspondem ao disco, o que deveria ter se movido e não se moveu, algo privado vazou para uma cópia pública. Invocado apenas, nunca dispara automaticamente: "landing-check", "did that land", "check my work".

O que é claude-skill-suite?

Este skill define um agente especializado chamado 'landing-check', projetado para validar se uma alteração de código realmente 'aterrissou' nos arquivos corretos em execução, se as afirmações documentadas (como relatórios, mensagens de commit, registros) são verdadeiras quando verificadas em disco, e se os efeitos colaterais necessários (propagação de correções, sincronização de cópias gêmeas, atualização de documentação) foram executados. Ele é invocado manualmente via comandos como '/landing-check' ou frases como 'did that land'. O agente opera em um contexto mínimo: recebe apenas os artefatos escritos (diff, status git, relatórios) e a lista de caminhos de repositório tocados, mas NÃO recebe a conta verbal do autor sobre o que foi feito — esta é uma regra crítica para evitar viés de confirmação. Ele re-deriva cada afirmação de forma independente, usando comandos diferentes dos originais, e examina tanto os arquivos de execução (verificando sombreamento, redirecionamento de hooks, cópias em múltiplas árvores) quanto a propagação de correções (localizando cópias irmãs da mesma alteração que não foram atualizadas). O resultado é um relatório conciso com uma linha de veredito ('SAFE TO COMMIT', 'FIX FIRST' ou 'UNVERIFIABLE'), tabelas de aterrissagem e de afirmações, uma lista de colaterais não movidos e confirmações do que está sólido. Ele não se sobrepõe ao '/code-review' (que analisa a qualidade do diff), ao '/audit' (varredura fria de todo o projeto) ou ao 'coding-conventions' (re-execução do código pelo autor), mas encaminha achados pertencentes a esses skills. O agente também utiliza uma ferramenta complementar 'landing-probe.js' para enumerar mecanicamente hooks, arquivos modificados, gêmeos e registros, sem emitir julgamentos. O skill é suportado por plataformas de agentes de IA que podem invocar ferramentas de sistema e ler artefatos, como Claude Code, Cursor ou Codex.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Evan-Daruwalla/claude-skill-suite/tree/HEAD/landing-check

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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 (e git diff --stat por 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 com git rev-parse --git-path hooks/<nome>, o resolvedor que o próprio git usa), ordem PATH para scripts, symlinks, cópias fornecidas sob node_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 \R compilou para X:Repo e 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:

  1. 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.
  2. 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.
  3. 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.
  4. 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 continha 0.0 para um verdadeiro 0.605.
  5. 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: 0 nã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, honra core.hooksPath) e qualquer cópia MORTA no outro lugar; um caminho registrado sem arquivo é AUSENTE.
  • CHANGED — staged / modificado / não rastreado por repositório; --file nomeia arquivos fora de qualquer repositório; --since N adiciona 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, IGUAL ou DIFERENTE (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. --all lista 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 ela RESOLVE.
  • REMOTE — ahead/behind por repositório, rotulado ref EM CACHE a menos que --remote tenha buscado primeiro. ahead N de 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, /audit ou coding-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.

Habilidades Relacionadas