GitWhy

Qu'est-ce que GitWhy ?

GitWhy est une « couche de contexte » pour Git qui enregistre et partage la justification du code généré par l’IA, liée directement aux commits qui l’ont produit. L’objectif est de rendre les prompts, décisions et compromis examinables en même temps que les modifications de code, plutôt que de laisser ces informations uniquement dans une fenêtre de chat.

Il capture un contexte structuré (comme le prompt initial, la justification, les décisions et les alternatives rejetées) et lie ce contexte aux commits. Le produit affiche ensuite la justification enregistrée dans les pull requests afin que les relecteurs voient pourquoi les changements ont été faits, et pas seulement le diff.

Fonctionnalités principales

• Contextes de « justification » structurés : Stocke un format fixe incluant le prompt, la justification, les décisions, les alternatives rejetées, les fichiers et les commits pour maintenir la cohérence des sorties entre les exécutions.
• Lié aux commits (provenance native git) : Chaque contexte enregistré est lié aux commits exacts qui l’ont produit, pour que la documentation reste ancrée dans l’historique du code.
• Affichage en PR via gitwhy-bot : Pousse la justification complète dans les pull requests sous forme de commentaires PR, rendant le contexte de relecture disponible pendant la revue de code.
• Synchronisation cloud et partage : Synchronise les contextes enregistrés vers le cloud pour que les équipes puissent les partager dans toute l’organisation.
• Recherche dans les contextes enregistrés : Permet aux utilisateurs de rechercher les justifications enregistrées par mot-clé, domaine ou sujet pour retrouver rapidement les décisions antérieures.
• Compatible avec les agents MCP : Conçu pour fonctionner avec n’importe quel agent compatible MCP (la page mentionne explicitement Claude Code, Cursor, Windsurf et Cline).
• Interface terminal pour la gestion : Fournit une interface terminal interactive pour parcourir, rechercher et gérer les contextes sans navigateur.

Comment utiliser GitWhy

1. Générez du code avec un agent compatible MCP et assurez-vous que l’agent produit une justification que vous souhaitez capturer.
2. Enregistrez le contexte de justification, où GitWhy consigne les éléments structurés (prompt, justification, décisions, alternatives rejetées, fichiers et commits) et les lie aux commits pertinents.
3. Synchronisez vers le cloud (pour le partage d’équipe) puis ouvrez une pull request.
4. Relecture en PR : Le bot de GitWhy publie la justification enregistrée dans la pull request pour que les relecteurs puissent lire les décisions et compromis sous-jacents.

Cas d’usage

• Revue PR pour les changements assistés par IA : Quand l’IA génère du code, les relecteurs peuvent lire la justification et les décisions stockées dans le commentaire PR au lieu d’inférer l’intention à partir du diff.
• Capture de connaissances d’équipe pour les choix de design récurrents : Les décisions sur l’authentification, la base de données et la conception d’API peuvent être stockées dans un arbre de contextes organisé par domaine/sujet, aidant les équipes à réutiliser les rationales passées.
• Audit du « pourquoi » derrière des commits spécifiques : Comme chaque contexte est lié aux commits qui l’ont produit, les développeurs peuvent retracer l’origine d’une décision jusqu’aux modifications de code exactes.
• Récupération plus rapide pendant un nouveau travail : Recherchez les contextes enregistrés par mot-clé, domaine ou sujet depuis le terminal, l’agent ou le tableau de bord d’équipe pour trouver rapidement la rationale pertinente.
• Workflows multi-agents : Les équipes utilisant différents agents compatibles MCP peuvent capturer et gérer les justifications en un seul endroit sans dépendre d’une interface de chat unique.

FAQ

• Quelles informations GitWhy stocke-t-il pour chaque contexte ? La page décrit un format structuré incluant le prompt, la justification, les décisions, les alternatives rejetées, les fichiers et les commits.

• Comment GitWhy relie-t-il la justification au code ? Il lie chaque contexte enregistré aux commits exacts qui l’ont produit.

• Où les relecteurs voient-ils la justification ? Le bot de GitWhy publie la justification complète dans les pull requests sous forme de commentaires PR.

• Peut-on l’utiliser sans navigateur ? Oui. Le produit inclut une interface terminal interactive pour parcourir, rechercher et gérer les contextes.

• Quels agents sont pris en charge ? Le site indique qu’il fonctionne avec n’importe quel agent compatible MCP et mentionne spécifiquement Claude Code, Cursor, Windsurf et Cline.

Alternatives

• Descriptions ou commentaires de PR simples : Les équipes peuvent coller manuellement la justification dans le texte de la PR, mais cela ne préserve pas automatiquement un historique structuré et lié aux commits expliquant les changements.
• Systèmes de documentation externe (wikis/bases de connaissances) : Les équipes peuvent maintenir des documents de décision séparément, mais ceux-ci ne sont pas intrinsèquement liés aux commits ni automatiquement affichés dans les PR.
• Revue d’historique local de logs/chats : La lecture d’anciens logs de chat peut fournir du contexte, mais c’est moins searchable et généralement non connecté aux commits dans l’historique du dépôt.
• Outils généraux de revue de code avec annotations : Les outils qui annotent les diffs peuvent expliquer les changements, mais le texte source met l’accent sur une justification structurée liée aux commits et publiée en PR via gitwhy-bot, ce qui peut ne pas être couvert par les outils de revue génériques.