Transformer des idées en code avec les sessions de proposition

Les sessions de proposition sont le bon point d’entrée lorsqu’une demande est trop importante pour être traitée par un simple prompt libre. Au lieu de modifier immédiatement, HagiCode transforme d’abord la demande en objectifs, périmètre, tâches et critères de validation, vous laisse les relire, et ne passe qu’ensuite à l’exécution.

Prérequis

Avant de démarrer une session de proposition, assurez-vous d’avoir :

• terminé l’une des méthodes d’installation (Microsoft Store ou Desktop) en suivant le Guide d’installation
• terminé la configuration avec l’assistant, qui crée votre premier Agent et au moins un projet
• suffisamment de contexte sur le projet pour décrire la modification ; sinon, commencez par Créer une session de conversation
• pour comprendre le flux de travail OpenSpec qui sous-tend les sessions de proposition, lisez d’abord l’Introduction à OpenSpec

À quoi servent les sessions de proposition

Les sessions de proposition conviennent surtout lorsque :

• la modification nécessite un périmètre clair avant le début de l’édition
• plusieurs dépôts, modules ou livrables sont concernés
• le travail doit être découpé en étapes relisibles
• vous voulez que le raisonnement et la trace d’exécution restent visibles par la suite

Si vous avez seulement besoin de comprendre le dépôt ou d’échanger de façon légère, une session de conversation est plus rapide. Si vous avez besoin de structure et de traçabilité, poursuivez ici.

Vue d’ensemble du flux de travail

Étape	Ce que vous faites	Ce qui se passe
Créer l’idée	Cliquez sur New Idea et décrivez la demande	Une session de proposition est créée et placée en file d’attente pour l’optimisation automatique
Relire le brouillon	Ouvrez la carte de la session	HagiCode affine le titre et la description et rédige le contexte, le problème, la solution et l’impact
Générer le plan	Cliquez sur Generate Plan	L’Agent écrit les fichiers du plan OpenSpec
Relire le plan	Lisez le plan dans l’onglet Review	Vous confirmez ou affinez le plan avant toute modification de code
Exécuter et archiver	Exécutez le plan, puis archivez-le	L’Agent exécute les tâches, et le plan terminé est archivé

Étape 1 : décrire la modification dans le panneau New Idea

Sélectionnez votre projet et cliquez sur New Idea (l’icône de pousse) dans la barre d’outils au-dessus du tableau des sessions. Le panneau Create Proposal s’ouvre.

Parcourez le panneau :

• Idea Name et Project Name (obligatoires) – confirment à quel projet appartient la demande.
• Scope – dans l’onglet Vault, cochez les vaults que l’IA peut modifier ; les vaults gérés par le système restent toujours en référence seule. Dans l’onglet Projects, ajoutez d’autres projets comme contexte.
• Quick Requests – des ajouts en un clic tels que No docs / tests, Self commit, Output English, Ask before edit et No backward compatibility.
• You Request – décrivez la modification réelle en langage naturel, jusqu’à 14 000 caractères. L’aperçu combiné (Combined preview) au-dessus montre exactement ce qui sera envoyé à l’IA.

Cliquez sur Submit idea. Si le travail touche plusieurs dépôts à la fois, définissez cette limite ici plutôt que de l’ajouter pendant l’exécution.

Étape 2 : relire la proposition dans la vue détaillée

Après l’envoi, l’idée apparaît sous forme de carte dans la colonne Proposal & Review, avec un badge d’état. Cliquez dessus pour ouvrir la vue détaillée de la proposition.

La vue réunit le plan, la progression et la conversation :

• Les Workflow steps (à gauche) indiquent où en est la proposition. Elles sont regroupées en Proposal preparation (Session Created, Auto Optimizing, Drafting Ready), Review and refine (Generating Plan Files, Review Plan), Execution complete (Executing Plan, Execution Completed) et Archive (Archiving, Archived).
• Les Planning directions indiquent les directions que le plan doit explorer, par exemple la cartographie des changements, le flux d’interaction ou l’architecture. Ajustez les valeurs par défaut dans Settings → Proposals and planning → Planning Direction.
• L’onglet Info (à droite) affiche la description rédigée (Context, Problem, Solution, Impact) et votre demande d’origine sous Chief Complaint. Des actions rapides permettent de Open Proposal Folder, Optimize Proposal, Open in New Window ou Delete Session.
• Les onglets Conversation et Review contiennent la discussion avec l’Agent et la relecture du plan généré.
• Quick Chat (en bas à gauche) vous permet d’envoyer un message à l’Agent sans quitter la vue.

Si l’objectif, le périmètre ou le découpage des tâches vous semble incorrect ici, corrigez la proposition avant de continuer. C’est tout l’intérêt de ce flux de travail.

Étape 3 : générer, relire, exécuter et archiver

Lorsque le brouillon est correct, cliquez sur Generate Plan. L’Agent écrit les fichiers du plan OpenSpec, et la session passe à Review Plan afin que vous puissiez vérifier le résultat avant toute modification de code. Après la relecture, la session se poursuit vers Executing Plan, puis vers Archiving et Archived.

HagiCode demande une confirmation avant les étapes difficiles à annuler, comme la génération d’une proposition, l’exécution immédiate ou l’archivage. Vous pouvez ajuster ces invites dans Settings → General → Confirm Prompts.

Après l’exécution, utilisez Super Commit pour transformer les modifications finales en messages de commit propres.

Étape 4 : suivre les propositions sur le tableau des sessions

Lorsqu’un projet compte plusieurs propositions, ou un mélange de propositions et de conversations, le tableau des sessions offre la vue d’ensemble la plus claire.

• Proposal & Review contient les idées en cours de rédaction, de génération et de relecture.
• Execution contient les sessions en cours d’exécution ou terminées.
• Archived garde le travail terminé à l’écart tout en le laissant disponible pour consultation.

Chaque carte affiche son état, par exemple Optimizing, Drafted, Reviewing, Executing ou Execution Complete. Vous pouvez changer la disposition du tableau avec le sélecteur de disposition ; voir Sessions.

Quand privilégier une session de proposition

Choisissez d’abord une session de proposition lorsque :

• la modification est complexe et que vous ne voulez pas que l’IA improvise trop tôt
• le travail sera relu ou partagé avec d’autres par la suite
• plusieurs dépôts, modules ou rôles sont concernés
• vous voulez que l’historique d’exécution et la justification restent réutilisables

Si la tâche est encore petite et exploratoire, une session de conversation est généralement la voie la plus légère.

Prochaines étapes

Créer une session de conversationSi vous devez encore comprendre le dépôt avant de planifier la modification, commencez par le flux de conversation, plus léger.

Super CommitAprès l'exécution de la proposition, poursuivez avec le guide pour générer des messages de commit plus propres à partir des modifications finales.