GitWhy

O que é o GitWhy?

GitWhy é uma “camada de contexto” para o Git que salva e compartilha o raciocínio por trás do código gerado por IA, vinculado diretamente aos commits que o produziram. O objetivo é tornar prompts, decisões e trade-offs revisáveis junto às alterações de código, em vez de deixar essas informações apenas em uma janela de chat.

Ele captura contexto estruturado (como o prompt original, raciocínio, decisões e alternativas rejeitadas) e vincula esse contexto aos commits. O produto então exibe o raciocínio salvo nos pull requests para que revisores vejam o porquê das mudanças, não apenas o diff.

Principais Recursos

• Contextos de “raciocínio” estruturados: Armazena um formato fixo incluindo prompt, raciocínio, decisões, alternativas rejeitadas, arquivos e commits para manter saídas consistentes entre execuções.
• Vinculado a commits (proveniência nativa do git): Cada contexto salvo é ligado aos commits exatos que o produziram, mantendo a documentação ancorada na história do código.
• Exibição em PR via gitwhy-bot: Envia o raciocínio completo para pull requests como comentários de PR, tornando o contexto de revisão disponível durante a análise de código.
• Sincronização em nuvem e compartilhamento: Sincroniza contextos salvos na nuvem para que times os compartilhem pela organização.
• Busca em contextos salvos: Permite buscar raciocínios salvos por palavra-chave, domínio ou tópico para encontrar decisões anteriores rapidamente.
• Funciona com agentes compatíveis com MCP: Projetado para qualquer agente compatível com MCP (a página menciona explicitamente Claude Code, Cursor, Windsurf e Cline).
• Interface de terminal para gerenciamento: Fornece uma interface interativa no terminal para navegar, buscar e gerenciar contextos sem precisar de navegador.

Como Usar o GitWhy

1. Gere código com um agente compatível com MCP e garanta que o agente produza o raciocínio que deseja capturar.
2. Salve o contexto de raciocínio, onde o GitWhy registra os itens estruturados (prompt, raciocínio, decisões, alternativas rejeitadas, arquivos e commits) e os vincula aos commits relevantes.
3. Sincronize na nuvem (para compartilhamento em equipe) e abra um pull request.
4. Revise no PR: O bot do GitWhy publica o raciocínio salvo no pull request para que revisores leiam as decisões e trade-offs subjacentes.

Casos de Uso

• Revisão de PR para mudanças assistidas por IA: Quando IA gera código, revisores podem ler o raciocínio e decisões armazenados no comentário do PR em vez de inferir intenções do diff.
• Captura de conhecimento da equipe para escolhas de design recorrentes: Decisões de autenticação, banco de dados e design de API podem ser armazenadas em uma árvore de contextos organizada por domínio/tópico, ajudando times a reutilizar racional anterior.
• Auditoria do “porquê” por trás de commits específicos: Como cada contexto é vinculado aos commits que o produziram, desenvolvedores podem rastrear a origem de uma decisão até as alterações de código exatas.
• Recuperação mais rápida durante novo trabalho: Busque contextos salvos por palavra-chave, domínio ou tópico do terminal, agente ou dashboard da equipe para encontrar racional relevante rapidamente.
• Fluxos de trabalho multi-agente: Times usando diferentes agentes compatíveis com MCP podem capturar e gerenciar raciocínio em um só lugar, sem depender de uma única interface de chat.

FAQ

• Que informações o GitWhy armazena para cada contexto? A página descreve um formato estruturado que inclui prompt, raciocínio, decisões, alternativas rejeitadas, arquivos e commits.

• Como o GitWhy conecta o raciocínio ao código? Ele vincula cada contexto salvo aos commits exatos que o produziram.

• Onde os revisores veem o raciocínio? O bot do GitWhy publica o raciocínio completo nos pull requests como comentários de PR.

• Pode ser usado sem navegador? Sim. O produto inclui uma UI interativa no terminal para navegar, buscar e gerenciar contextos.

• Quais agentes são suportados? O site afirma que funciona com qualquer agente compatível com MCP e menciona especificamente Claude Code, Cursor, Windsurf e Cline.

Alternativas

• Descrições ou comentários simples em PRs: Times podem colar o raciocínio manualmente no texto do PR, mas isso não preserva automaticamente um histórico estruturado e vinculado a commits do motivo das mudanças.
• Sistemas externos de documentação (wikis/bases de conhecimento): Times podem manter docs de decisões separadamente, mas eles não estão inerentemente ligados a commits nem aparecem automaticamente nos PRs.
• Revisão de histórico de log/chat local: Ler logs de chat anteriores pode fornecer contexto, mas é menos pesquisável e geralmente não conectado aos commits no histórico do repositório.
• Ferramentas gerais de code review com anotações: Ferramentas que anotam diffs podem explicar mudanças, mas o texto fonte enfatiza raciocínio estruturado, vinculado a commits e postagem em PRs via gitwhy-bot, o que pode não ser coberto por ferramentas genéricas de review.