MaleusMaleus

Affiner les spécifications avec l'agent

Commentez les specs rédigées par l'agent, puis envoyez-lui vos commentaires. Il les reçoit comme instructions d'affinage et réécrit les parties concernées.

Dans l'appDétail de version
Sur cette page

Maleus rédige votre cahier des charges. L'affinage, c'est la façon de lui demander de changer ce qu'il a écrit. Vous n'éditez jamais les specs comme des fichiers : vous commentez ce qui cloche, et l'agent réécrit ces parties-là.

Cela se passe dans l'étape Spécifications d'une version guidée. Ce n'est pas disponible sur les versions directes, qui éditent le code tout de suite.

Où le trouver

  1. Ouvrez la version en développement.
  2. Choisissez l'étape Spécifications dans l'en-tête. L'arborescence des specs occupe la zone principale, répartie en Functional, Backend et Frontend, chacune avec son compteur.
  3. Ouvrez une spec. Le bouton Comments dans la barre d'outils du document porte le nombre de commentaires ouverts et déplie le panneau de droite.

Commentez la spec elle-même. Le panneau de droite garde la liste.

Commenter ce qui cloche

Deux façons de laisser un commentaire, qui se comportent ensuite de la même manière :

OùCommentCe que vous obtenez
Sur un passageSélectionnez le texte, puis Commenter cette sélectionUn marqueur numéroté relie le commentaire à ce passage précis
Sur tout le documentAjouter un commentaire général en haut du panneauUn commentaire rattaché à la spec, sans ancrage

Les commentaires s'accumulent dans l'onglet Ouverts. Rien ne part encore vers l'agent : vous pouvez parcourir plusieurs specs et tout marquer avant de déclencher un tour.

Gardez un commentaire par sujet. « Ajouter un bouton d'export CSV à ce tableau » marche mieux qu'une liste de souhaits en plusieurs paragraphes. Vous pouvez envoyer un premier lot et en ouvrir un second juste après.

Les envoyer à l'agent

Cochez les commentaires à envoyer, ou Tout sélectionner, puis envoyez. Maleus demande confirmation : Envoyer {n} commentaires à l'agent ? L'agent les reçoit comme instructions d'affinage, et les commentaires passent dans l'onglet Envoyés.

Envoyer plusieurs commentaires d'un coup compte. L'agent voit tous les changements demandés dans le même tour, il peut donc garder les specs cohérentes entre elles plutôt que d'en corriger une et d'en casser une autre.

Les mises à jour proposées reviennent dans le chat. À partir de là, soit vous les acceptez et l'arborescence se met à jour, soit vous répondez dans le chat pour demander des ajustements.

Ouverts, Envoyés, Résolus

Le panneau a trois onglets, et un commentaire circule entre eux :

  • Ouverts : ce que vous avez écrit et pas encore envoyé.
  • Envoyés : ce qui a été transmis à l'agent.
  • Résolus : ce qui est réglé. Résoudre un commentaire le range ici, et vous pouvez le rouvrir à tout moment, ce qui le renvoie dans Ouverts.

Supprimer un commentaire l'efface définitivement, avec ses réponses. Résoudre est l'option réversible : préférez-la.

Synchroniser depuis le codebase

Si votre projet est connecté à un repository, l'arborescence propose une action de synchronisation qui réinjecte la source de vérité actuelle dans les specs. Ce n'est pas de l'affinage. L'affinage propose des changements via l'agent ; la synchronisation réconcilie le modèle de specs avec ce que le codebase contient réellement.