Votre premier cycle de travail

Ce tutoriel utilise une récompense de pointage pour vous guider dans la rédaction d’une première intention, sa vérification ou son implémentation, puis la consignation d’une nouvelle décision. Vous apprendrez à juger si une exigence est satisfaite à partir du code réel du projet et des résultats de vérification.

Il vous faut Noea avec un Agent au statut « Prêt » et un projet local sur lequel travailler. S’il ne comporte pas de pointage, remplacez cet exemple par une règle aussi précise.

Ouvrir le projet de code

Choisissez Ouvrir un dossier… dans l’espace de travail, ou Fichier → Ouvrir un dossier d’implémentation…, puis le dossier contenant votre code.

À sa première ouverture, Noea crée un projet lié. Il ouvre directement un projet existant, ou vous demande de choisir si plusieurs y sont liés. Consultez Ouvrir et gérer les projets pour les autres méthodes.

Écrire votre première intention

Cliquez sur Nouvelle intention dans la barre latérale et nommez-la « Pointages quotidiens ». Noea ajoute l’extension .noea.md et ouvre le document. Écrivez :

# Pointages quotidiens

Les utilisateurs peuvent pointer une fois par jour. Accorder une récompense à l’utilisateur après 7 jours consécutifs de pointage.

Enregistrez avec ⌘S sur macOS ou Ctrl+S sur Windows / Linux. Commencez par les décisions déjà prises ; inutile d’énumérer tous les cas limites dès maintenant.

Choisir entre analyse et implémentation

Expliquer vérifie dans tout le projet les contenus dont les explications nécessitent une attention. L’action Analyse d’un paragraphe vérifie uniquement ce contenu. Les deux examinent l’implémentation et créent ou actualisent les explications ; elles ne modifient pas le code.

Si le pointage existe déjà, cliquez sur Expliquer dans la barre latérale. Pour vérifier seulement ce paragraphe, survolez-le et choisissez Analyse à gauche.

Si la règle reste à implémenter, démarrez une conversation, saisissez @ pour sélectionner le document d’intention, puis envoyez :

Implémente la récompense de pointage dans ce projet conformément à l’intention référencée. Examine d’abord le code existant, respecte la structure du projet et vérifie à la fois une série de 7 jours et un pointage manqué.

Vous pouvez aussi utiliser Réaliser dans la barre latérale lorsque ce bouton est disponible ; voir Implémenter avec un Agent. La conversation affiche les réponses, appels d’outils et modifications de fichiers pendant son travail.

Après l’implémentation, cliquez sur Expliquer si l’action n’a pas démarré automatiquement. Toute modification de code dans une conversation ordinaire ne déclenche pas une mise à jour des explications.

Lire une explication de l’implémentation

Revenez au document d’intention et cliquez dans un espace vide du paragraphe, hors de son texte, pour ouvrir la note en marge. Lisez ces sections :

• Réalisation : comment le code compte les jours consécutifs et attribue les récompenses.
• Éléments probants : code, sorties de commandes ou documents de test cités par l’explication.
• Points d’attention : lacunes, choix d’implémentation, risques ou suggestions nécessitant votre jugement.

Vous pourriez découvrir que l’implémentation définit les jours calendaires à partir du fuseau horaire de l’appareil. Vérifiez le comportement réel du projet et sa conformité à vos exigences. Ouvrez les références pour évaluer jusqu’où elles étayent l’explication.

Une explication terminée ne signifie pas que les tests ont été relancés. Distinguez code de test, résultats historiques et vérifications effectuées pendant cette exécution ; voir Lire les explications et les éléments probants. Si l’implémentation ne satisfait pas l’exigence initiale, corrigez-la au lieu de réécrire la règle pour l’adapter au code.

Poser une question et consigner une décision

Survolez le paragraphe et choisissez Poser une question à ce sujet à gauche. Noea insère une référence dans la saisie. Ajoutez puis envoyez votre question :

Comment l’implémentation actuelle gère-t-elle les voyages entre fuseaux horaires ? Pointer depuis deux endroits peut-il affecter la série ? Explique-le à partir du code.

Une fois le comportement compris, décidez si vous souhaitez encadrer le calcul. Si oui, envoyez :

Ajoute « Un jour correspond à la date calendaire du lieu où se trouve actuellement l’utilisateur » à cette intention. Soumets-moi d’abord la modification d’intention pour relecture.

Lorsque l’Agent soumet une proposition, cliquez sur Voir les modifications et lisez les ajouts et remplacements. Modifiez la nouvelle formulation si nécessaire, puis choisissez Accepter mes modifications, ou Accepter si aucune retouche n’est nécessaire.

Si la proposition nécessite une implémentation, son acceptation poursuit ce travail dans la même conversation. Si l’implémentation existante la satisfait déjà, aucune nouvelle exécution d’implémentation n’est nécessaire. Vérifiez ensuite les résultats de la tâche d’explication ou lancez une analyse manuelle au besoin.

Vérifier vos acquis

Avant de terminer, enregistrez le document et confirmez que son explication couvre la formulation actuelle. Essayez de répondre avec vos mots à quatre questions :

1. Comment cette exigence est-elle implémentée et quels éléments étayent cette conclusion ?
2. Quel choix important l’Agent a-t-il fait sans qu’il figure dans l’intention ?
3. Est-ce que je comprends et accepte ce choix ? Doit-il devenir une contrainte durable ?
4. Quelle phrase modifierais-je la prochaine fois que je voudrai changer ce comportement ?

Vous devriez par exemple pouvoir expliquer la définition d’un jour, retrouver les éléments probants et désigner « 7 jours consécutifs » comme condition de récompense. Si une réponse reste floue, posez une question sur le paragraphe concerné.

Inutile de consigner toutes les règles dès la première visite. Ajoutez la prochaine décision à conserver lorsqu’elle se présente.

Lisez ensuite Formuler les intentions qui comptent et Lire les explications et les éléments probants.