Hydra.
PrésentationENVoir le repo

Un corps,
plusieurs têtes.

Une équipe design dans Claude Code. Tu lui donnes un sujet brut, ou simplement une question. Hydra le cadre, l'analyse, regarde ce qui se fait ailleurs, ouvre des pistes et les compose en protos avec ton design system. Tu reçois des livrables sur lesquels tu peux trancher.

À quoi ça sert

Un écran qui ne marche pas assez bien, un nouvel écran à concevoir, une page à auditer, les bonnes pratiques d'un composant, une idée à challenger, un libellé à choisir, un build à recetter. Hydra fait le travail d'une petite équipe autour du designer (analyse, recherche, exploration, rédaction, recette), et c'est le designer qui décide.

Ce n'est pas une machine à sortir des écrans. Hydra réfléchit avant de composer. Il établit ce qui est vrai chez toi, cherche ce qui marche ailleurs, met plusieurs pistes en concurrence, et te dit laquelle il recommande, pourquoi, et avec quelles preuves. Il ne te dit pas ce que tu veux entendre : si une idée est faible, il le dit et explique pourquoi. Et quand il ne sait pas, il le dit au lieu d'inventer.

Comment ça marche

  1. Tu donnes un sujet. Le problème en une phrase, l'existant s'il y en a un, et tes documents dans le dossier du sujet, sous topics/.
  2. Cortex cadre, en un seul message. Il dit ce qu'il a trouvé et ce qui manque, la métrique qui jugera le sujet et son seuil, qui est touché, le périmètre, ce qui est déjà décidé, les rendus à produire (mobile, desktop, selon ta plateforme) et le mode de déroulé. Tu corriges d'un mot.
  3. Les têtes s'enchaînent. L'audit établit ce qui est vrai sur l'existant, research trouve ce qui se fait ailleurs, ideation ouvre les pistes et choisit, maquette les compose, writer vérifie les textes.
  4. Tu récupères les livrables. Hydra te propose aussi d'ajouter au contexte ce que le sujet a appris : une métrique, un profil, un terme. Rien n'y est écrit sans ton accord.

Une demande, pas forcément un sujet

Tout ne demande pas la chaîne complète. Hydra choisit les têtes d'après ta demande, tu n'as pas à les nommer. Il s'arrête au livrable que tu as demandé et te propose la suite, sans l'enchaîner tout seul.

Tu demandesTu reçois
« Audite cette page », « trouve les points de friction de ce parcours »La fiche et le rapport : constats priorisés, hypothèses, références, actions. Hydra propose ensuite d'ouvrir des pistes.
« Quels sont les meilleurs patterns pour… », « les bonnes pratiques de… »Un livrable de recherche court : la réponse, son niveau de confiance, les écrans en images et les liens vers les sources.
« Que disent les études sur… », « qu'est-ce qui marche pour… », sur une question préciseUn livrable de recherche : ce que les études, les articles et les guides établissent, ce que ça change pour ton sujet, et le niveau de preuve.
Un benchmark ou un état de l'art approfondiLa fiche et un livrable de recherche complet : conclusions, ce qu'on ne sait pas, références datées, avec des produits visités en direct.
« Challenge cette idée », « aide-moi à trancher »La fiche et le rapport : les pistes, leur critique, une recommandation. Hydra propose ensuite de les composer en protos.
« Quel libellé pour… », « relis ces textes »Des variantes argumentées, dans la conversation, ou un tableau pour un écran entier.
« Est-ce conforme à la maquette ? »La recette : la liste des corrections pour le développeur, avec les valeurs mesurées.

Deux façons de dérouler

Au cadrage, cortex te recommande un mode, et c'est toi qui choisis.

D'un trait

  • Sans pause : Hydra va jusqu'au bout de ta demande
  • Ce qu'il a dû supposer est noté en hypothèses, à relire
  • Ce qui n'est pas à lui de décider remonte en questions
  • Pour un sujet bien cadré, à question fermée

Étape par étape

  • Des pauses aux moments clés
  • Tu tranches avant la suite
  • La même profondeur, seules les pauses changent
  • Pour un sujet large, aux pistes à construire

Les protos, tout de suite ou après ta relecture. Au cadrage, cortex te demande aussi quand composer les protos, la partie qui coûte le plus. Soit tout de suite, soit après que tu as lu la fiche, le rapport et le brief. Dans ce cas, Hydra s'arrête au brief, et tu demandes les protos si les pistes en valent la peine.

Hydra peut contester ta demande, mais il y répond quand même. S'il pense que le problème est mal posé, il te le dit, et te montre sa façon de le voir à côté, clairement signalée. Mais ses pistes et sa recommandation servent ton objectif, pas le sien. Une contrainte de ta mission (une règle légale, un principe de marque) change la façon d'atteindre l'objectif, jamais l'objectif lui-même. Certaines décisions ne sont jamais à lui : la définition du problème, la métrique et son seuil, le périmètre. Elles te reviennent, même d'un trait.

Dans ta langue

Hydra te parle et écrit ses livrables dans la langue de travail de ta mission : celle dans laquelle tu lui écris, que l'accueil note avec toi. Dans le doute, il prend le français. En anglais, tout passe en anglais : les titres, les noms des livrables et les pages rendues. Dans une autre langue, le texte est dans ta langue et les titres restent en anglais.

Les textes des protos suivent la langue de ton produit, qui peut être différente : tu peux travailler en français sur un produit en anglais. Un libellé ou une citation tirés du produit restent tels quels, jamais traduits. La méthode, elle, reste écrite en français, mais tu n'as pas à la lire.

Les têtes

Chaque tête a sa méthode. Cortex décide comment mener le sujet, les autres font. La phase de discovery d'un sujet en réunit deux : l'audit, qui regarde ton existant, et research, qui regarde ailleurs.

Cortex
Le chef d'orchestre. Cadre le sujet, recommande un mode, enchaîne les têtes utiles, et vérifie avant de clore que rien n'a été oublié.
Audit
Comprendre ton existant. Analyse ton écran et ton parcours, en ligne ou en maquette, les croise avec tes documents et tes données, et sépare les faits des hypothèses. Pour savoir ce qui se fait ailleurs, il appelle research.
Research
Ce qui se fait et ce qui est prouvé ailleurs. Des écrans de vrais produits, cherchés d'après ce que fait l'utilisateur et pas seulement dans ton secteur. Des produits visités en ligne, des design systems publics, des études, des articles et des guides sur une question précise, dont il tire ce qui compte pour ton sujet. Chaque référence est sourcée, datée et cliquable. Les autres têtes l'appellent quand elles ont besoin de références.
Ideation
Ouvrir, puis trancher. Des pistes vraiment différentes, au moins deux formes pour chaque levier, une critique sans complaisance, et un choix sur des critères annoncés.
Maquette
Composer les écrans. Un proto manipulable par piste, avec les composants de tes librairies, dans les rendus de ta plateforme. Ce que ton design system n'a pas est dessiné en schéma, et signalé comme tel.
Writer
Les textes d'interface. Vérifie les textes des protos par rapport à ta charte de ton. Sans charte, il se fie au ton qu'il relève dans ton produit.
Recette
La maquette face au build. Mesure les deux côtés, en desktop et en mobile, chiffre chaque écart, et donne au développeur une liste de corrections.
Accueil
La première session. Explique Hydra, remplit le contexte avec toi à partir de tes sources, et lance ton premier sujet.

Ce que tu récupères

Les livrables d'un sujet

  • 01 · La fiche : le cadrage, avec le problème, la métrique et son seuil, qui est touché, le périmètre, les rendus et ce qui est décidé
  • 02 · Le rapport : constats, hypothèses, références, pistes critiquées et recommandation. Ou la recherche, quand la recherche est le sujet
  • 03 · Le brief : pour chaque piste, ce que l'écran doit montrer, et un texte de composition que n'importe qui peut reprendre dans son outil
  • La galerie : un proto par piste, sur le même écran de départ. Seul le levier change, pour comparer sur pièce, en mobile et en desktop si ta plateforme le demande

La recette

  • Un tableau par zone de l'écran, pour le desktop et pour le mobile
  • Pour chaque écart, la valeur attendue et la valeur mesurée sur le build, et la sévérité
  • Une capture annotée, avec les écarts numérotés
  • Un tableau et pas de prose, parce qu'il part au développeur

Tout est écrit dans le dossier du sujet, en markdown transformé en pages HTML. Les références visuelles y sont rangées en images que tu ouvres partout. Les protos sont des pages HTML : ils s'ouvrent dans le navigateur, se cliquent, et ne touchent jamais à ta maquette dans l'outil de design. Un sujet terminé se range dans topics/.archive/.

Le contexte, c'est ta mission

La méthode est la même pour tous. Le dossier context/ l'adapte à ta mission : le client, le périmètre, le vocabulaire métier, les utilisateurs, les métriques, le design system, le ton, les outils, la langue. Changer de mission, c'est remplacer ce dossier, et rien d'autre.

Le premier jour

L'accueil pose les modèles vides et les remplit avec toi, à partir de tes réponses, d'un brief de mission ou d'une restitution d'étude. La mission d'abord, parce que c'est elle qui rapporte le plus : le domaine précis, tes plateformes, le vrai jargon de l'équipe, ce qu'elle peut absorber.

Au fil des sujets

Rien n'a besoin d'être complet tout de suite. À chaque cadrage, Hydra compare ce que le sujet nomme avec ce que contient le contexte, demande ce qui manque, puis propose de l'ajouter. Il l'écrit avec ton accord, et n'invente jamais pour boucher un trou.

Le design system se lit dans tes librairies. Hydra en rédige les fondations, la liste des composants et les règles d'usage (principes, ce qui est figé ou libre, règles par composant, comportement responsive), et tu les valides. Si ton équipe a déjà un fichier de design system en markdown, il s'utilise tel quel. Les utilisateurs se décrivent par axes plutôt que par personas : ce qui fait varier une décision de design, et les combinaisons qui reviennent, chacune avec son niveau de preuve. La charte de ton est facultative. Sans elle, writer relève le ton de ton produit et te le propose.

Branché sur les outils de ta mission

Hydra ne connaît aucun outil par son nom. Il lit ceux que ta mission déclare, rôle par rôle, et s'en sert.

Outil de design
Maquettes et design system. Lit un écran, sa structure et ses valeurs. Pour un nouvel écran, prend les composants dans tes librairies.
Benchmark
Ce qui se fait. Écrans et parcours de vrais produits. Si tu as plusieurs outils, il les prend dans ton ordre de préférence. Sans outil, l'accueil te propose Lazyweb, qui est gratuit, et Hydra visite les produits en ligne.
Le navigateur
Captures et mesures. Hydra regarde chaque proto qu'il compose, et mesure le build pendant une recette.
Analytics
Les chiffres d'usage. Quand une donnée manque (la valeur d'un indicateur, l'étape où les gens décrochent), Hydra la cherche dans l'outil avant de la déclarer absente. Il ne prend que des chiffres agrégés, chacun avec sa source. Il passe par un connecteur, ou par l'API de l'outil avec une clé qui reste sur ta machine et ne passe jamais par la conversation. Sans outil, il lit les exports que tu déposes.

Un outil déclaré mais pas branché : Hydra t'aide à le brancher. Aucun outil pour un rôle : il le dit, fait sans, et baisse sa confiance là où ça compte. Jamais en silence.

Les garde-fous

Ce qu'Hydra s'interdit

  • Inventer un composant, une valeur, une convention
  • Affirmer sans source : tout se cite et se vérifie
  • Proposer un dark pattern : urgence artificielle, coût caché, sortie cachée
  • Écrire dans ton contexte sans ton accord
  • S'inspirer d'un autre sujet : la structure d'un livrable vient de la méthode

Ce que ses outils vérifient

  • Chaque proto est capturé, et Hydra doit regarder ses captures avant de rendre
  • La galerie vérifie que chaque piste du rapport a son proto, et clique un par un les boutons des protos. Un bouton qui ne fait rien est signalé
  • Les livrables suivent leur gabarit, en français comme en anglais. Un sigle de la mission non défini, ou une référence réduite à un identifiant, est signalé
  • Les compteurs d'une recette tombent juste avec son tableau
  • Un fichier d'instructions étranger à Hydra, chargé dans la session, est signalé

L'accessibilité et le mobile first font partie des règles que toute piste doit tenir, avec celles que ta mission déclare.

Ce qu'Hydra ne fait pas

Ce qui vient

Des idées, pas des promesses :

Pour qui

Pour un product designer en mission qui veut un vrai partenaire de travail : quelqu'un qui analyse l'existant, va chercher les références, challenge ses idées au lieu de les flatter, et lui rend des livrables sur lesquels il peut décider.

Démarrer

Une session, et l'accueil te guide

Il te faut Claude Code avec accès à Opus, Node.js 22 ou plus récent, et Chrome. Tu peux installer Hydra de deux façons, pour la même méthode : en plugin de Claude Code, pour le seul dossier de ta mission (deux commandes, et une pour le mettre à jour), ou en copie, à télécharger en ZIP, sans git. Les prérequis et l'installation sont dans le README.fr.md, sur github.com/MCQX7/hydra-agent.

En plugin, lance ensuite Claude Code dans le dossier de ta mission et écris « je viens d'installer Hydra ». Il y pose ses règles et les modèles de ton contexte, et l'accueil reprend quand tu relances Claude Code dans ce dossier. En copie, ouvre la session dans le dossier d'Hydra et commence par « je viens de lancer Hydra ». L'accueil remplit ton contexte avec toi, puis tu lances ton premier sujet.

Compte quelques minutes pour une question, et vingt à trente minutes pour un sujet complet jusqu'aux protos. Hydra est réglé pour Opus en effort élevé, et c'est voulu. Il marche aussi avec Sonnet ou un effort plus bas si ton abonnement ne permet pas mieux, mais ses livrables sont alors moins bons.