Aller au contenu
DiffwrightBêta

pourquoi

Pourquoi Diffwright existe

La review de code est l’un des moments les plus déterminants du travail d’une équipe. Diffwright a un objectif : la rendre plus rapide, plus sûre et plus complète, sans jamais retirer la décision à la personne qui relit.

  1. le constat

    La review mérite mieux qu’une corvée

    La review est un moment clé dans la vie d’une équipe. C’est là qu’elle partage ce qu’elle sait, qu’une erreur est rattrapée avant d’atteindre la production, qu’une façon de travailler se transmet. C’est aussi, jour après jour, une part importante du temps des développeurs, et plus encore de celui des lead developers.

    Dans Azure DevOps, ce temps se passe dans l’interface web. Elle fait son travail, mais elle est parfois lente, et elle ne montre pas le rendu de certains fichiers : une image modifiée, un PDF ou un document Word apparaissent comme un contenu brut, qu’il faut télécharger et ouvrir ailleurs pour comprendre ce qui a changé.

    Ces frictions s’additionnent. On passe d’un onglet à l’autre, on perd le fil d’un diff trop bruyant, l’attention s’émousse au fil des pull requests. C’est précisément dans ces moments-là qu’un détail important finit par passer. Diffwright part de ce constat : la review décide d’une bonne partie de la qualité d’un projet, elle mérite un outil conçu pour elle.

  2. la première version

    Une première version, éprouvée sur macOS

    La première réponse a pris la forme d’une application pour macOS, utilisée au quotidien sur de vraies reviews. Elle faisait le gros du travail en local et affichait les fichiers tels qu’ils sont vraiment : les images, les PDF et les documents Word, plutôt que leur contenu brut.

    Cette première version a surtout établi ce qui compte. Que la rapidité change réellement la façon de relire : quand l’outil répond tout de suite, on ose ouvrir un fichier de plus, vérifier un appel de plus. Que l’IA peut aider, à condition de rester à sa place. Et qu’une règle doit être posée dès le départ : rien n’est publié sur la plateforme sans une action explicite de la personne qui relit.

    Deux limites ont décidé de la suite. L’application ne fonctionnait que sur macOS, alors que les équipes travaillent aussi sous Windows. Et certaines briques de son interface, comme la sélection sur plusieurs lignes, la minimap ou l’aperçu des documents Word, atteignaient les limites de leur fondation technique.

  3. le tournant

    Reconstruit pour macOS et Windows

    Diffwright a donc été reconstruit de zéro, avec une exigence claire : rester aussi rapide que la première version, sur macOS comme sur Windows.

    Rien n’a été perdu pour autant. La première version est devenue la référence de comportement de la nouvelle : ses tests décrivent ce que Diffwright doit faire, et ce sont eux qui tranchent en cas de doute. Le travail lourd, comme les échanges avec la plateforme (Azure DevOps, GitHub ou GitLab), le calcul des diffs ou le pilotage de l’IA, tourne en arrière-plan pour que l’interface reste réactive. Le diff, lui, s’affiche dans un véritable éditeur de code.

    L’interface a été repensée plutôt que recopiée. Diffwright s’organise comme un éditeur de code, avec des panneaux que l’on redimensionne et que l’on replie, pour que la pull request, ses fichiers et la review tiennent dans un même espace de travail.

  4. convictions

    Quatre principes qui ne se négocient pas

    Quatre principes guident Diffwright depuis sa première version. Ce ne sont pas des options cachées dans les réglages : ils encadrent chaque nouvelle fonction, et une idée qui obligerait à en sacrifier un est abandonnée.

    Pour l’IA, ils tiennent en une phrase.

    L’IA propose, vous décidez.

    1. Chaque écriture est un clic

      Publier un commentaire, voter, fusionner, résoudre un fil : rien de tout cela ne part vers Azure DevOps, GitHub ou GitLab sans un clic explicite sur l’élément concerné. Jamais depuis une tâche de fond, jamais depuis une sélection cochée d’avance, jamais par une nouvelle tentative automatique. La personne qui relit reste celle qui signe.

    2. Une IA qui aide, que vous choisissez

      Par défaut, l’IA passe par la CLI claude que vous avez installée, ou par un modèle local via Ollama. Codex CLI et les moteurs facturés à l’usage (Anthropic, compatibles OpenAI) sont possibles, mais seulement sur option : avec votre propre clé, conservée sur votre ordinateur, et un consentement explicite pour chaque service. La review automatique ne s’active jamais avec un moteur payant. Chaque suggestion se valide, se modifie ou s’ignore. Et si aucune IA n’est disponible, ou si vous la désactivez, ses fonctions disparaissent de l’interface au lieu de rester grisées.

    3. Le contenu du dépôt reste suspect

      Fichiers de configuration, consignes de review, pages testées : tout cela vient du dépôt, donc potentiellement de n’importe quel contributeur. Diffwright ne l’exécute jamais sans confirmation, ne l’affiche jamais comme du HTML et protège les consignes envoyées à l’IA contre les tentatives d’injection.

    4. La vitesse est une fonctionnalité

      Passer d’une pull request à l’autre, d’un fichier au suivant, doit être instantané. Pas d’animation qui retarde la navigation, pas d’écran d’attente quand l’information est déjà là. Une review rapide est une review que l’on fait vraiment.

  5. les testeurs

    Donner une voix aux testeurs

    Une pull request ne concerne pas que les développeurs. Les testeurs, souvent moins à l’aise avec les outils techniques, y jouent un rôle décisif, et leur retour mérite mieux qu’un message rapide, sans contexte, difficile à reproduire.

    Diffwright leur donne un outil à la hauteur : un retour de test publié directement dans la pull request, complet et exploitable par la personne qui corrige.

    L’onglet Test permet d’annoter une capture d’écran et de la joindre à la review, accompagnée au besoin des erreurs relevées sur la page testée. Comme pour le reste, rien n’est envoyé avant que la personne ne publie elle-même son retour.

  6. aujourd’hui

    Diffwright aujourd’hui

    Diffwright est une application de bureau pour macOS et Windows, dédiée à la review des pull requests Azure DevOps. La prise en charge de GitHub et de GitLab est disponible en bêta, et l’application elle-même est en bêta publique.

    Cette bêta suit une règle de rigueur : une fonction n’est considérée comme vérifiée qu’après avoir été exercée face à une vraie organisation ou un vrai compte. Tant que ce n’est pas le cas, elle reste signalée comme non vérifiée.

    L’interface continuera d’évoluer au fil des versions. Les principes ci-dessus, eux, restent fixes.

  7. la suite

    Et maintenant

    Diffwright continue de progresser dans la même direction : moins de friction pour la personne qui relit, une IA qui reste un assistant, et un retour de test qui aide vraiment l’équipe.

    Si vous relisez des pull requests dans Azure DevOps, GitHub ou GitLab, installez Diffwright et faites votre prochaine review avec. Une question, ou une fonction qui vous manque ? Écrivez via la page Contact : chaque message est lu.