Garder les explications à jour — Documentation de Noea Code

Après avoir modifié l’intention ou le code, vérifiez si les explications restent valables. Utilisez Expliquer dans la barre latérale pour traiter les explications à vérifier dans tout le projet, ou l’action Analyse d’un paragraphe pour un contenu précis.

Identifier ce qui a changé

Statut	Signification	Étape suivante
Contenu à analyser	Une formulation nouvelle ou modifiée n’a pas sa propre explication.	Enregistrer, puis analyser. Implémenter d’abord si l’exigence n’est pas encore satisfaite.
Explication du texte précédent	Le paragraphe a changé, mais la note explique encore l’ancienne formulation.	Examiner les différences et analyser à nouveau.
Peut-être obsolète	Des fichiers lus ou cités par l’explication ont changé.	Examiner ces fichiers et revérifier l’explication.
Aucun changement détecté	Aucun contenu n’attend d’analyse ni n’est marqué comme potentiellement obsolète.	Continuer à lire ou à vérifier des questions précises au besoin.

« Peut-être obsolète » ne signifie pas forcément qu’une conclusion est fausse : la modification d’un fichier peut être sans rapport. « Aucun changement détecté » ne prouve ni que les tests passent ni que toutes les fonctionnalités sont complètes.

Analyser un seul paragraphe

Enregistrez le document, survolez le paragraphe et choisissez Analyse à gauche. Une note existante peut aussi proposer Analyser à nouveau.

Seule l’explication du contenu sélectionné est mise à jour. L’analyse est indisponible tant que ce contenu comporte des modifications non enregistrées ; Noea vous invite à enregistrer d’abord.

Après avoir modifié le code empêchant les récompenses en double, analysez par exemple la règle correspondante pour vérifier que son explication décrit l’implémentation actuelle.

Actualiser les explications du projet

Cliquez sur Expliquer dans la barre latérale pour vérifier les contenus à analyser et les explications dont les fichiers justificatifs ont changé. L’action est indisponible si aucun projet n’est ouvert, si le projet est en lecture seule ou si aucun dossier d’implémentation n’est lié.

Une tâche Expliquer lancée manuellement ouvre une conversation montrant étapes, progression et résultats individuels. Vous ne pouvez pas y envoyer de messages ordinaires pendant son exécution, mais vous pouvez utiliser les autres conversations du projet.

À la fin, développez les résultats pour voir quelles explications ont changé, lesquelles restent exactes et quelles vérifications ont échoué ou restent inachevées. Une tâche terminée ne signifie pas que tous les contrôles ont réussi.

Comprendre ce qui a été vérifié

Expliquer compare intention et code et vérifie les explications de paragraphe et locales. L’action conserve les contenus exacts et actualise ceux à corriger ; elle ne réécrit pas nécessairement toutes les explications.

Une explication actualisée ne signifie pas que les tests ont été relancés. Pour vérifier un comportement, demandez les contrôles dans une conversation ordinaire, puis analysez le contenu concerné. Consultez Lire les explications et les éléments probants pour interpréter leur périmètre.

Connaître les déclenchements automatiques

Réglages → Projet actuel → Automatisation → Expliquer automatiquement après l’implémentation est activé par défaut. Voici les principaux déclencheurs :

Action	Expliquer automatiquement
Accepter une proposition modifiant l’intention et nécessitant une implémentation.	Après la fin normale de sa tâche d’implémentation.
Accepter une proposition modifiant l’intention, déjà satisfaite par l’implémentation.	Après l’acceptation.
Démarrer le travail avec Réaliser dans la barre latérale.	Après la fin normale du premier tour.
Accepter un plan d’organisation modifiant le texte de l’intention.	Après l’acceptation, indépendamment du réglage ci-dessus.
Réorganiser uniquement les noms de fichiers ou les dossiers.	Pas de déclenchement.
Modifier seulement le code dans une conversation ordinaire, choisir Implémenter directement, ou interrompre ou faire échouer une implémentation.	Pas de déclenchement ; lancer Expliquer manuellement.

Expliquer s’exécute automatiquement en arrière-plan sans créer de conversation ordinaire. Poursuivez votre conversation initiale et suivez la progression sous Exécutions.

Consulter les traces et relancer

La section Exécutions de la barre latérale conserve les tâches d’explication. Développez une tâche pour consulter les traces en lecture seule de ses exécutions. Elles restent disponibles après un changement de conversation ou un redémarrage.

Après un échec ou une interruption, choisissez Relancer. Les explications existantes sont conservées. À la fin de la nouvelle exécution, vérifiez que les éléments auparavant en échec ou inachevés ont été traités.

Choisir un Agent pour chaque opération

L’Agent utilisé par Expliquer dépend de la manière dont la tâche démarre. Consultez Agents, modèles et utilisation pour les réglages des opérations et leur portée.

Si les explications ne se mettent pas à jour, consultez Dépannage et questions fréquentes.