GitWhy

Cos'è GitWhy?

GitWhy è un “livello di contesto” per Git che salva e condivide il ragionamento dietro al codice generato dall’AI, collegato direttamente ai commit che lo hanno prodotto. L’obiettivo è rendere revisionabili prompt, decisioni e compromessi insieme alle modifiche del codice, invece di lasciarli solo in una finestra di chat.

Cattura contesto strutturato (come il prompt originale, il ragionamento, le decisioni e le alternative scartate) e lo collega ai commit. Il prodotto poi rende visibile il ragionamento salvato nelle pull request, così i revisori possono vedere il perché delle modifiche, non solo la diff.

Funzionalità Principali

• Contesti di “ragionamento” strutturati: Memorizza un formato fisso che include prompt, ragionamento, decisioni, alternative scartate, file e commit per mantenere gli output consistenti tra le esecuzioni.
• Collegato ai commit (provenienza nativa git): Ogni contesto salvato è legato ai commit esatti che lo hanno generato, così la documentazione resta ancorata alla cronologia del codice.
• Visibilità nelle PR tramite gitwhy-bot: Invia il ragionamento completo nelle pull request come commenti PR, rendendo il contesto di review disponibile durante la revisione del codice.
• Sincronizzazione cloud e condivisione: Sincronizza i contesti salvati sul cloud per consentire alle squadre di condividerli in tutta l’organizzazione.
• Ricerca tra i contesti salvati: Permette di cercare il ragionamento salvato per parola chiave, dominio o argomento per trovare rapidamente decisioni precedenti.
• Funziona con agent compatibili MCP: Progettato per funzionare con qualsiasi agent compatibile MCP (la pagina menziona esplicitamente Claude Code, Cursor, Windsurf e Cline).
• Interfaccia terminale per la gestione: Fornisce un’interfaccia terminale interattiva per navigare, cercare e gestire i contesti senza bisogno di un browser.

Come Usare GitWhy

1. Genera codice con un agent compatibile MCP e assicurati che l’agent produca il ragionamento che vuoi catturare.
2. Salva il contesto di ragionamento, dove GitWhy registra gli elementi strutturati (prompt, ragionamento, decisioni, alternative scartate, file e commit) e li collega ai commit rilevanti.
3. Sincronizza sul cloud (per la condivisione con il team) e poi apri una pull request.
4. Review nella PR: Il bot di GitWhy pubblica il ragionamento salvato nella pull request così i revisori possono leggere le decisioni e i compromessi sottostanti.

Casi d'Uso

• Review PR per modifiche assistite dall’AI: Quando l’AI genera codice, i revisori possono leggere il ragionamento e le decisioni memorizzate nel commento PR invece di dedurre l’intento dalla diff.
• Cattura conoscenza del team per scelte di design ricorrenti: Decisioni su autenticazione, database e design API possono essere memorizzate in un albero di contesti organizzato per dominio/tema, aiutando le squadre a riutilizzare razionali passati.
• Audit del “perché” dietro commit specifici: Poiché ogni contesto è collegato ai commit che lo hanno generato, gli sviluppatori possono tracciare l’origine di una decisione fino alle modifiche codice esatte.
• Recupero più rapido durante nuovo lavoro: Cerca contesti salvati per parola chiave, dominio o argomento dal terminale, agent o dashboard del team per trovare rapidamente razionali rilevanti.
• Workflow multi-agent: Squadre che usano diversi agent compatibili MCP possono catturare e gestire il ragionamento in un unico posto senza dipendere da un’interfaccia chat singola.

FAQ

• Quali informazioni memorizza GitWhy per ogni contesto? La pagina descrive un formato strutturato che include prompt, ragionamento, decisioni, alternative scartate, file e commit.

• Come collega GitWhy il ragionamento al codice? Collega ogni contesto salvato ai commit esatti che lo hanno generato.

• Dove vedono i revisori il ragionamento? Il bot di GitWhy pubblica il ragionamento completo nelle pull request come commenti PR.

• Si può usare senza browser? Sì. Il prodotto include un’interfaccia terminale interattiva per navigare, cercare e gestire i contesti.

• Quali agent sono supportati? Il sito afferma che funziona con qualsiasi agent compatibile MCP e menziona specificamente Claude Code, Cursor, Windsurf e Cline.

Alternative

• Descrizioni o commenti PR semplici: I team possono incollare manualmente il ragionamento nel testo della PR, ma questo non preserva automaticamente una cronologia strutturata e collegata ai commit del motivo dei cambiamenti.
• Sistemi di documentazione esterni (wiki/basi di conoscenza): I team possono mantenere documenti decisionali separatamente, ma questi non sono intrinsecamente legati ai commit né emergono automaticamente nelle PR.
• Revisione di log/chat history locali: Leggere i log di chat precedenti può fornire contesto, ma è meno ricercabile e generalmente non collegato ai commit nella cronologia del repository.
• Strumenti di code review generici con annotazioni: Gli strumenti che annotano i diff possono spiegare i cambiamenti, ma il testo qui enfatizza il ragionamento strutturato e collegato ai commit con pubblicazione nelle PR tramite gitwhy-bot, che potrebbe non essere coperto dagli strumenti di review generici.