Découvrir Noea Code

Noea Code (Noea en abrégé) vous aide à comprendre et à décider du comportement de votre logiciel lorsque vous le développez avec l’IA. Vous consignez les exigences, un Agent de programmation modifie le code, puis vous vérifiez le résultat à l’aide d’explications de l’implémentation, d’éléments probants et de points d’attention.

Commencez par une seule règle dans un projet existant. Un comportement produit, une contrainte d’architecture ou une exigence algorithmique peut constituer votre première intention.

Une intention exprime les exigences que votre logiciel doit continuer à satisfaire. Elles restent pertinentes après l’achèvement d’une fonctionnalité. Lorsque vous décidez d’en changer le comportement, vous modifiez les mots correspondants. Inutile de décrire toute l’application : commencez par ce qui compte pour vous.

Relier intention et implémentation

Imaginons une application de pointage quotidien dans laquelle vous écrivez :

Accorder une récompense à l’utilisateur après 7 jours consécutifs de pointage.

Cette phrase fixe la condition de récompense, mais laisse plusieurs choix ouverts : la définition d’un jour, la conséquence d’un pointage manqué et le type de récompense. L’Agent doit tout de même faire ces choix lors de l’implémentation.

Noea relie la phrase à une explication de l’implémentation. Vous pouvez lire comment le code compte les jours, ouvrir les références au code ou les documents de test qui étayent l’explication, et repérer les exigences non satisfaites ou les choix à discuter. Si un jour doit correspondre à la date locale de l’utilisateur, ajoutez cette décision à l’intention pour que les travaux futurs la respectent.

Connaître les trois types de contenu

Les documents d’intention sont des fichiers Markdown. Vous pouvez les suivre avec Git ou les modifier dans un autre éditeur. Noea stocke les explications séparément et les affiche en marge. Certains libellés de l’interface appellent les documents d’intention Source ; il ne s’agit pas du code du dossier d’implémentation.

Suivre le cycle de travail quotidien

1. Clarifier l’intention. Rédigez-la directement, ou discutez-en avec l’Agent et relisez sa proposition.
2. Implémenter et comprendre. Laissez l’Agent travailler, puis analysez l’implémentation et lisez l’explication, les éléments probants et les points d’attention.
3. Consigner vos décisions. Posez une question sur un paragraphe précis, ajoutez les exigences à conserver et poursuivez l’implémentation et les vérifications.

Si le code existe déjà, écrivez l’exigence à vérifier puis lancez Expliquer. S’il reste à l’implémenter, utilisez une conversation ou l’action Réaliser.

Vous pouvez accepter un choix que vous comprenez sans transformer chaque détail d’implémentation en exigence durable. Consultez Lire les explications et les éléments probants pour décider de ce qui appartient à l’intention.

Comprendre les rôles de Noea et de l’Agent

Noea fournit l’espace de travail pour rédiger des documents, discuter des décisions, relire les modifications et lire les explications. L’Agent lit le projet, appelle des outils et modifie le code. Choisissez un Agent pris en charge et utilisez les modèles et méthodes de connexion qu’il propose.

Dans le processus de proposition de Noea, les modifications de vos documents d’intention nécessitent votre décision. Vous pouvez modifier et accepter une proposition, ou l’écarter. Les modifications du code et les commandes dépendent des capacités et autorisations de l’Agent.

Les explications ne remplacent ni les tests ni l’utilisation réelle. Examinez les éléments probants des comportements importants et vérifiez-les au besoin.

Commencer par une petite question utile

Choisissez un sujet précis avec un résultat observable : quand attribuer une récompense, comment gérer un stock insuffisant ou quelle contrainte une API doit respecter. Vous pouvez conserver votre processus de développement habituel pour le reste du projet.

Passez à Installer et préparer Noea, puis suivez Votre premier cycle de travail.