Focus Plans
Un Focus Plan est un espace de travail limité : les priorités du jour, la liste
des vérifications d’une version, un correctif urgent ou une enquête précise. Il
est enregistré sur votre serveur AirCode Ø, hors du dépôt. Il n’encombre donc
pas TODO.md et n’apparaît pas dans les différences Git. Un projet peut avoir
plusieurs plans actifs.
Ouvrez-les depuis Focus Plans dans la barre d’activité ou, sur mobile, depuis Plus → Focus Plans.
| Espace | Où se trouvent les données | Usage |
|---|---|---|
| TODO du projet | Dans le TODO.md du dépôt |
Orientations durables que les contributeurs doivent voir et relire avec le code |
| Focus Plan | Sur le serveur AirCode Ø | Travail délimité pour la journée, un sprint, un correctif ou une enquête |
| Plan de session | Dans une conversation avec un agent | Étapes internes de l’agent pour la demande en cours |
Garder un plan en tête de liste
Dans le menu d’un Focus Plan, choisissez Épingler le Focus Plan. La mention Épinglé apparaît et le plan reste au-dessus des autres, même si vous triez par date de mise à jour, avancement ou titre. Choisissez Désépingler le Focus Plan pour le rendre au tri normal.
Sur le web de bureau et le web adaptatif, Vue d’ensemble place les plans épinglés dans une section avant les groupes de priorité. L’application native les place en tête de sa galerie. L’action et son résultat sont les mêmes sur les trois interfaces. Restaurez un plan archivé avant de modifier son épinglage.
Créer un plan depuis une conversation
Le plus simple est de demander à l’agent qui connaît déjà le travail restant de créer le Focus Plan à la fin de votre échange :
vous — Crée maintenant un Focus Plan à partir de cette discussion.
L’agent crée un plan dans le projet actuel avec les tâches définies ensemble et
vous donne son identifiant. Actualisez la vue Focus Plans : le plan y apparaît,
avec created by agent dans son historique.
Ensuite, dans cette conversation ou dans une autre session du même projet :
vous — Ajoute « Recréer l’APK Android » au plan de sortie Android.
vous — Marque la fiche Store comme terminée et note qu’il manque encore les captures d’écran.
vous — Place la vérification de signature en premier dans le plan.
vous — Renomme le plan « Sortie Android », puis archive-le : c’est publié.
Vous n’avez pas besoin de citer l’identifiant du plan. Son titre suffit : l’agent consulte les plans du projet pour retrouver celui que vous désignez.
Ce qu’un agent peut faire
| Demande | Résultat |
|---|---|
| Créer un plan | Nouveau plan actif dans le projet de la session, avec les tâches convenues |
| Ajouter, modifier, supprimer ou réordonner des tâches | Modification de leur état, de leurs notes et de leurs échéances |
| Renommer ou décrire le plan | Modification des informations du plan |
| Épingler ou désépingler | Placer le plan en tête ou le rendre au tri normal |
| Terminer, archiver ou rouvrir | Modifier le cycle de vie ; terminer n’archive pas, archiver ne supprime pas |
| Supprimer définitivement | Possible seulement pour un plan archivé et si vous demandez précisément sa suppression |
Ce qu’un agent ne fait pas
- Il n’agit que si vous le demandez. Il ne transforme pas son plan interne de session en Focus Plan et ne range pas vos plans en arrière-plan.
- Il reste dans le projet. Une session ne peut accéder qu’aux Focus Plans de son propre projet.
- Il ne modifie pas le dépôt. Les outils Focus Plan n’écrivent jamais dans
TODO.md; ce fichier reste sous contrôle humain. - Les plans archivés restent en lecture seule jusqu’à leur réouverture. Un Focus Plan doit être archivé avant de pouvoir être supprimé définitivement.
- Il n’écrase pas vos changements. Chaque modification faite par un agent est attribuée à sa session dans l’historique du plan. Une modification fondée sur une ancienne version est refusée si vous avez changé le plan entre-temps.
Les outils Focus Plan sont disponibles dans les sessions locales. Une session dans l’environnement Docker isolé ne reçoit pas ces outils : aucun plan ne peut lui être rattaché. Reprendre dans Docker une ancienne session qui avait un plan retire ce rattachement périmé sans bloquer la reprise.
Joindre une capture d’écran à une tâche
Une tâche peut contenir plusieurs fichiers, notamment des captures d’écran. Utilisez Joindre un fichier à côté de la tâche, collez une image dans le champ ou déposez-y un fichier. Dans l’application mobile, le bouton + de la fenêtre de la tâche donne accès aux photos, aux fichiers et à l’appareil photo. Les pièces jointes s’affichent sous forme de pastilles, les images s’ouvrent en plein écran et les fichiers restent liés à la tâche après actualisation.
Comme pour une image jointe à un prompt, le fichier est envoyé à côté du projet, en dehors du dépôt, puis reste associé à la tâche. Quand vous lancez une session sur cette tâche, l’agent reçoit aussi la capture : aucune autre action n’est nécessaire.
Exécuter une tâche
Le bouton de lancement d’une tâche ouvre un panneau concis avec le moteur, le modèle, l’effort et les autorisations, puis démarre la session. Vous n’avez pas de prompt à rédiger : le titre et les notes de la tâche en tiennent lieu. Choisissez Modifier le prompt… pour ouvrir le formulaire de lancement complet, modifier le périmètre ou joindre un fichier. Ces sessions utilisent l’environnement local.
Une tâche lancée passe automatiquement à En cours. Si vous l’aviez déjà marquée bloquée, terminée ou en cours, elle conserve l’état choisi.
Pendant que l’agent travaille, la ligne de la tâche indique s’il est actif, attend votre réponse ou a terminé. Le même bouton ouvre la session existante au lieu d’en lancer une seconde. Les agents d’un même projet partagent les mêmes fichiers ; lancer plusieurs tâches en même temps risque donc de créer des modifications qui se chevauchent. Le panneau vous en informe au lancement.
Quand un tour se termine, la ligne propose Marquer comme terminée. L’arrêt de l’agent ne prouve pas que le travail est achevé : le plan attend votre décision.
L’action Démarrer une session sur le plan lui-même lance une seule session pour toutes les tâches restantes, dans leur ordre. Elle ne crée pas une session par tâche.
La conversation affiche une bannière Focus Plan pendant ce travail. Vous y voyez le vrai nombre de tâches terminées, un segment par tâche, la tâche actuelle ou suivante et un état comme En cours, Votre réponse attendue, Bloqué, En pause ou Terminé. Ouvrez la bannière pour consulter chaque tâche ou accéder au plan complet. Elle suit les modifications enregistrées pendant que l’agent travaille ; la fin d’un tour la met en pause sans jamais marquer le travail comme terminé.
L’option Mises à jour spontanées du plan règle l’initiative de l’agent, pas ses autorisations. Si elle est activée, l’agent enregistre aussi son avancement vérifié sur le périmètre du plan pendant le travail, sans attendre une demande pour chaque étape. Si elle est désactivée, le plan ne change que sur demande.
Synchroniser l’avancement avec l’AI
Utilisez Synchroniser avec l’AI si une partie du travail a pu être faite en dehors du Focus Plan. Choisissez un agent et un modèle ; AirCode Ø lance alors en arrière-plan une analyse en lecture seule des tâches inachevées, du dépôt, de ses tests et des éléments Git pertinents.
Le résultat est une proposition à examiner, pas une modification automatique. Chaque tâche reçoit un verdict étayé : probablement terminée, partielle, sans trace ou impossible à vérifier. AirCode Ø ne marque aucune tâche comme achevée avant votre acceptation. L’analyse apparaît dans Runs, jamais comme une conversation dans Sessions. Vous pouvez l’annuler depuis le Focus Plan tant qu’elle est en cours.
Où les données sont enregistrées
Les Focus Plans sont stockés dans SQLite, dans le dossier d’état d’AirCode Ø sur
la machine qui exécute le serveur. Ils ne sont ni écrits dans le dossier du
projet, ni enregistrés dans Git, ni ajoutés à TODO.md. Sauvegardez aussi le
dossier d’état du serveur pour les conserver.