Mostrar HN: Grepathy – Claude tomou uma decisão que ninguém aprovou

Quando um agente de codificação cria um recurso, ele toma uma série de pequenas decisões que você nunca aprovou. Mais tarde, alguém analisa o PR e pergunta "por que isso foi feito dessa maneira?" e você não sabe. A resposta está enterrada em uma transcrição de bate-papo em seu laptop, e Claude Code as exclui após 30 dias por padrão.

Grepathy lê as transcrições da sua sessão localmente, extrai as decisões e as grava em um arquivo markdown que é confirmado com o seu código. Agora o repo pode responder "por quê" sozinho, para revisores, colegas de equipe e futuros agentes. Exemplo real: em um projeto de contrato, meu agente decidiu por conta própria pré-criar usuários convidados no Clerk.

Não estava em nenhum plano. O CTO viu isso no PR e me perguntou por quê. Eu não tinha ideia, porque não tinha tomado essa decisão.

Com Grepathy, estaria no repositório: Execute grep -rn "agent-initiated" .ai/why/ e você obterá uma lista de todas as decisões que o agente tomou sem perguntar a ninguém. Você não comanda Grepathy. Ele funciona sozinho: como um futuro agente atende ao porquê - dois gatilhos automáticos, ambos lendo o pacote de porquês confirmado, para que o agente nunca precise se lembrar de procurar: Sem servidor, sem contas, sem bot.

É uma CLI, alguns ganchos e arquivos markdown no git. Detalhes completos em docs/how-it-works.md. Sua transcrição nunca sai da sua máquina.

A única coisa que é compartilhada é o resumo da redução, e o resumidor segue regras rígidas: nunca cita suas mensagens, nunca descreve sua confusão ou idas e vindas, nunca inclui detalhes comerciais ou financeiros e revela segredos. Duas verificações determinísticas ficam por trás do prompt (um scanner secreto/financeiro e uma regra de que cada entrada deve apontar para código real) e, em seguida, você revisa o arquivo antes de enviar. Se você editar ou excluir uma entrada, Grepathy respeitará isso para sempre.

Executamos uma avaliação cega e pré-registrada em relação a uma linha de base honesta e publicamos tudo, incluindo as partes onde a ferramenta foi perdida: docs/REPORT.md. Como isso difere do Beads e das ferramentas de rastreamento de tarefas? Eles rastreiam o que os agentes devem fazer a seguir.

Grepathy registra por que as coisas já foram feitas. Você poderia usar ambos. Por que não simplesmente desativar a exclusão de transcrições?

Você pode, mas você tem gigabytes de registros brutos de bate-papo em um laptop que nunca compartilharia com ninguém. O arquivo do porquê é pequeno, seguro para compartilhar e fica no repositório onde sua equipe e seus agentes podem realmente encontrá-lo. Funciona com outras ferramentas além do Claude Code?

Qualquer coisa pode ler os arquivos do porquê, já que eles são apenas descontos. Escrevê-los atualmente requer Claude Code. Um adaptador Codex é o próximo.

Onde estão os mergulhos profundos? Arquitetura e comportamento do git · formato porquê-pack · agentes paralelos · configuração Zero dependências de tempo de execução; TypeScript puro. O conjunto de testes é hermético - não é necessário Claude, chave de API ou rede (o LLM é ridicularizado, o git é executado em repositórios temporários descartáveis) - portanto, o teste npm é executado em qualquer lugar com Node >= 20 e git.

Ele cobre análise de transcrição, mesclagem de pacote de porquê e preservação de edição humana, desduplicação semântica, validador de privacidade/segredo/finanças, estado por sessão e bloqueio de simultaneidade, atribuição de ramificação e confirmação automática de índice de rascunho. Consulte CONTRIBUTING.md. O adaptador do lado de gravação e o padrão de ponteiro/gancho do lado de leitura são costuras por ferramenta projetadas para tornar uma nova ferramenta (por exemplo, Codex) uma pequena adição.