Formuler les intentions qui comptent

Les documents d’intention décrivent les comportements et contraintes que votre logiciel doit satisfaire. Écrivez ce que vous avez décidé, puis affinez-le à mesure que l’implémentation et les éléments probants vous apprennent quelque chose. Le document reste ainsi lisible tout en laissant à l’Agent une marge d’implémentation.

Choisir les exigences à conserver

L’intention peut décrire plusieurs types d’exigences :

Décrivez la condition de déclenchement et un résultat observable. « L’export doit être fiable » est difficile à vérifier. « Si l’export échoue, conserver les filtres actuels et permettre un nouvel essai » offre une base d’évaluation plus claire.

Lorsqu’un choix d’implémentation est assez important pour devoir être respecté à l’avenir, inscrivez-le dans l’intention. Les détails non décidés peuvent rester des choix d’implémentation.

Distinguer exigences durables et tâche du jour

L’intention décrit ce que le logiciel doit continuer à faire. Ce n’est pas une liste à supprimer une fois le travail terminé. Conservez les exigences après l’achèvement d’une fonctionnalité et modifiez les mots concernés lorsque vous décidez de changer son comportement.

Les conversations contiennent aussi des instructions pour le travail en cours. Faites cette distinction :

Demandez-vous ce que la phrase contraint réellement. « Valider les données avant chaque export » définit l’ordre d’exécution du logiciel et relève de l’intention. « Examiner d’abord le module d’export cette fois-ci » organise la tâche actuelle.

Indiquez à l’Agent quelles instructions sont durables et lesquelles ne concernent que cette tâche. Répétez les instructions ponctuelles importantes au besoin ; ne présumez pas qu’une nouvelle conversation en hérite.

Créer et modifier un document

Cliquez sur Nouvelle intention dans la barre latérale et saisissez un nom. Noea crée à la racine du dossier d’intention un fichier .noea.md avec un titre de niveau un.

Les documents utilisent Markdown, avec lecture et modification dans la même vue. Cliquez sur le texte pour le modifier et structurez-le avec des titres, listes, tableaux et blocs de code.

Par exemple :

# Pointages quotidiens

Les utilisateurs peuvent pointer une fois par jour.

## Récompenses

Accorder une récompense à l’utilisateur après 7 jours consécutifs de pointage. N’attribuer la récompense qu’une seule fois au sein d’une même série.

Utilisez les titres pour les sections et les paragraphes pour les exigences distinctes. L’analyse traite une liste entière comme un seul contenu. Séparez les sujets en paragraphes ou sections si vous voulez les analyser et en discuter indépendamment.

Développer l’intention par la discussion

Si une règle reste floue, discutez-en avant de demander une proposition de modification :

Je veux éviter les récompenses de pointage en double. Aide-moi à définir ce que « en double » signifie ici et attends ma confirmation avant de proposer une modification d’intention.

Une fois la décision prise, demandez à l’Agent d’en faire une proposition. Relisez la formulation, modifiez le nouveau texte au besoin et acceptez-le. Une déclaration dans une conversation ne fait partie du document d’intention qu’une fois écrite dedans.

Le texte doit employer des concepts et des mots que vous comprenez. Demandez des explications sur les termes inconnus ou les exigences ajoutées avant de les conserver. Une bonne formulation permet d’expliquer soi-même l’exigence et de retrouver la phrase à modifier pour obtenir un autre comportement.

Pour les propositions et cartes de suggestion, consultez Discuter et relire les modifications d’intention.

Illustrer les relations par des diagrammes

Un bloc de code marqué mermaid peut être rendu sous forme de diagramme. Utilisez-le pour illustrer transitions d’état, processus ou relations entre modules.

La commande en haut à droite alterne entre diagramme et source. Passez à la source pour modifier. En cas de syntaxe invalide ou de type non pris en charge, Noea affiche la source et la raison ; le reste du document reste lisible.

Enregistrer et utiliser des éditeurs externes

Enregistrez manuellement avec ⌘S sur macOS, Ctrl+S sur Windows / Linux, ou Fichier → Enregistrer. Un point près du titre indique des modifications non enregistrées. Changer d’onglet les conserve ; fermer le document, le projet ou l’application déclenche une demande d’enregistrement.

L’enregistrement normalise la mise en forme Markdown. Vous pouvez aussi modifier les fichiers avec un éditeur externe. Si un fichier change sur le disque pendant sa modification dans Noea, l’application propose de le recharger ou de l’enregistrer sous un autre nom plutôt que de l’écraser directement.

Comprendre l’effet d’une reformulation

Ajouter, remplacer et supprimer du texte affecte différemment les exigences :

Retirer « La récompense doit être un badge » ne rend pas nécessairement invalide une implémentation existante par badge. Elle peut toujours satisfaire l’intention restante. Pour supprimer entièrement les récompenses, précisez qu’elles ne doivent plus être attribuées au lieu de supprimer seulement une exigence sur leur forme.

Avant de modifier, demandez à l’Agent quels comportements changeraient et quelles exigences devraient rester. Utilisez sa réponse comme base de discussion, puis vérifiez l’implémentation et les éléments probants réels.

Après l’enregistrement, les anciennes explications affichent Texte précédent. Si la nouvelle exigence nécessite des modifications de code, implémentez-la avant l’analyse. Pour seulement vérifier le comportement existant, analysez directement.

Poursuivez avec Implémenter avec un Agent ou Garder les explications à jour.