Cartes

Une carte est à la fois un élément de travail et l’emplacement durable de ses sessions agent, messages, fichiers, état Git, commentaires et historique.

Créer une carte

Cliquez sur Nouvelle carte ou sur le plus d’une colonne. Le prompt décrit l’objectif de l’agent ; le titre est optionnel et peut être généré depuis ce prompt.

La fenêtre permet de configurer :

• colonne de destination et labels ;
• identifiant, agent fournisseur, modèle et effort de raisonnement ;
• dépôt principal ou worktree Git isolé avec branche personnalisée ;
• mode Auto et choix de pipeline propres à la carte ;
• Boucle planifiée qui relance la carte sur place ;
• exécution Agent structurée ou Terminal interactif.

Joignez les fichiers d’entrée nécessaires. Utilisez les mentions @ de fichiers et commandes ou skills / lorsque l’agent choisi les prend en charge. Ne collez jamais mot de passe ou token dans le prompt normal ; utilisez l’action de secret masqué dans la conversation.

Écrire un bon prompt

Décrivez le résultat attendu, les contraintes importantes, fichiers ou composants pertinents et la manière de vérifier la fin. N’imposez pas des détails d’implémentation inutiles. Une bonne carte laisse l’agent inspecter le dépôt avant d’arrêter son plan.

Ouvrir et suivre le travail

Cliquez sur une carte pour ouvrir son panneau. Les principaux onglets sont :

• Conversation — messages utilisateur, réponses agent, appels d’outils, questions et zone de saisie ;
• Diff — fichiers changés dans le worktree ou dépôt actif ;
• Historique — sessions et événements importants de la carte.

L’en-tête expose statut/colonne, contrôles d’exécution et actions supplémentaires. Plusieurs panneaux peuvent rester ouverts, dans la limite choisie par l’utilisateur et de la largeur disponible.

Statut et activation

Les états d’exécution usuels comprennent inactif, en cours, en attente d’une réponse, terminé, en erreur et annulé. Déplacer une colonne et changer un statut d’exécution sont deux choses différentes : une session terminée ne déplace pas forcément la carte sans mode Auto ou automatisation.

Vous pouvez activer un travail différé, annuler un agent, relancer une session, envoyer un nouveau message ou déplacer la carte. Les contrôles se désactivent lorsqu’un verrou, une permission ou un état incompatible rend l’action dangereuse.

Déplacer, archiver et supprimer

Glissez les cartes ou utilisez leurs actions. L’entrée dans une colonne active peut lancer le travail ; la sortie peut mettre en pause, reprendre, remettre le contexte à zéro, nettoyer le worktree, archiver ou déclencher des hooks selon les réglages.

L’archive masque le travail terminé sans effacer son historique. Les cartes supprimées passent dans la corbeille si la rétention projet est active et restent restaurables jusqu’à la suppression définitive. La corbeille ne remplace pas une sauvegarde.

Cartes externes et project-agent

Les intégrations peuvent importer des tickets externes sous forme de cartes liées. Certains boards affichent aussi du travail project-agent avec les cartes Kanban. Leurs actions et champs faisant autorité peuvent différer ; Stib affiche l’état de synchronisation et ses erreurs au lieu d’écraser silencieusement une modification non prise en charge.

Suite : Agents, Pipeline et Intégration Git.