Discuter et relire les modifications d’intention

Lorsqu’une discussion aboutit à une nouvelle décision produit, demandez à l’Agent d’en faire une proposition d’intention. Relisez la formulation, ajustez-la au besoin et décidez si vous souhaitez l’inscrire dans vos documents.

Partir d’un contexte précis

Survolez un paragraphe pertinent et choisissez Poser une question à ce sujet à gauche. Noea insère une référence dans la saisie et affiche le document à côté de la conversation. Aucun message n’est envoyé automatiquement.

Vous pouvez aussi saisir @ pour rechercher documents, paragraphes ou explications. Le contenu choisi apparaît sous forme de pastille de référence et accompagne votre message à l’Agent.

Par exemple :

Cette règle de récompense ne précise pas ce qui arrive après un pointage manqué. Explique le comportement actuel à partir de l’implémentation, puis discutons de la possibilité de rattraper un pointage.

Une fois la décision prise, demandez une proposition :

Ajoute « Autoriser un pointage de rattrapage par mois » à cette règle. Soumets-moi la modification d’intention pour relecture.

Corriger le code ou changer l’exigence ?

Si intention et implémentation divergent, demandez-vous d’abord si l’exigence initiale tient toujours. Supposons que le document exige une récompense après 7 jours consécutifs, mais que le code l’attribue au jour 6 :

Ne réécrivez pas l’intention uniquement pour accommoder le code existant. Vérifiez d’abord que l’Agent a compris l’exigence, puis que le code la satisfait. Clarifiez les malentendus, corrigez les erreurs d’implémentation et ne changez l’intention que lorsque vous décidez de changer la règle.

Pour une correction, soyez explicite :

Conserve l’exigence de 7 jours. Corrige la récompense prématurée, vérifie que le jour 6 ne donne rien et que le jour 7 donne une récompense, sans adapter l’intention au code actuel.

Distinguer suggestions et propositions

Une carte de suggestion consigne un ajout à l’intention que l’Agent juge utile. Adopter lance dans la conversation actuelle sa transformation en proposition déjà satisfaite par l’implémentation existante ; cette action n’écrit pas directement dans l’intention. Écarter indique que vous ne retenez pas la suggestion.

Une proposition contient des modifications précises de documents à relire. Après sa soumission par l’Agent, sa carte apparaît lorsque le tour actuel se termine, s’arrête ou échoue. Choisissez Voir les modifications pour l’examiner.

Relire les modifications dans le document

La vue de relecture conserve la mise en page du document. Les insertions ont un fond vert pâle ; les suppressions un fond rouge pâle et du texte barré. Les remplacements montrent ancien et nouveau texte, avec les changements mot à mot surlignés lorsque cela convient.

Utilisez la barre inférieure pour passer d’une modification à l’autre, ou sélectionnez un nom de fichier pour changer de document. Une décision porte sur toute la proposition et tous ses fichiers. Vous ne pouvez pas accepter séparément un paragraphe ou un fichier.

Vous pouvez modifier le texte inséré et la nouvelle partie d’un remplacement. Le texte original, les suppressions et les paragraphes inchangés ne sont pas modifiables pendant cette relecture. Après modification, l’action principale devient Accepter mes modifications.

Avant de décider, examinez non seulement les mots changés, mais aussi ce qu’ils exigent :

• Pouvez-vous expliquer les conditions et termes ajoutés avec vos propres mots ?
• Une instruction ponctuelle a-t-elle été prise pour une exigence durable ?
• L’Agent a-t-il discrètement affaibli une contrainte pour l’adapter au code existant ?
• Saurez-vous retrouver la bonne phrase au prochain changement de comportement souhaité ?

Si quelque chose reste flou, revenez à la conversation et demandez à l’Agent d’expliquer ou de réviser la proposition.

Choisir une action

Acceptez une décision relue si elle doit guider le développement futur. Implémenter directement ne consigne pas cette demande comme intention.

Écarter une proposition n’annule pas les modifications de code déjà réalisées. L’Agent peut, par exemple, avoir terminé le travail avant de proposer de consigner le comportement existant.

Gérer propositions révisées et documents modifiés

L’Agent peut réviser une proposition dans la même conversation. La nouvelle version remplace la relecture en attente ; l’ancienne carte conserve un avis de version. Les retouches non acceptées de l’ancienne relecture ne sont pas transférées automatiquement.

Si le document actuel ne correspond plus au texte de départ de la proposition, l’acceptation est désactivée. Utilisez Demander à l’agent une nouvelle proposition sur la version actuelle pour qu’il relise le document et crée des modifications applicables.

Après l’acceptation

Une proposition nécessitant une implémentation se poursuit dans la conversation actuelle. Si elle n’aboutit pas, utilisez Poursuivre l’implémentation sur la carte. Revenez ensuite au document et vérifiez l’explication ; lancez Expliquer manuellement si elle n’a pas été actualisée.

Pour empêcher l’ouverture automatique des relectures, désactivez Réglages → Projet actuel → Automatisation → Ouvrir la relecture automatiquement, puis ouvrez la relecture depuis la carte. Ce réglage contrôle l’ouverture de la relecture, pas l’acceptation de la proposition.

Poursuivez avec Garder les explications à jour.