Approfondissement et annexes

Collaborer avec des agents IA

Sommaire

TandemLoop est conçu dès le départ pour que des agents IA externes travaillent sur les mêmes données en partenaires à part entière. L’app elle-même ne contient pas d’IA — vous y reliez l’outil d’IA agentique de votre choix (voir Connecter un outil d’IA). Le dossier de données ne contient pas de format opaque, mais du Markdown en texte brut que n’importe quel outil peut lire. Un cadre de travail clair s’applique néanmoins : c’est vous qui décidez de ce qui arrive à votre structure.

Le principe du tandem

L’image du tandem décrit bien cette collaboration : vous êtes assis devant et donnez la direction ; l’agent est assis derrière et fournit la force. Aucune des deux parties n’agit de sa propre initiative. Pour l’app, cela signifie :

  • Vous définissez la vision, les priorités, les relations et les décisions.
  • L’outil d’IA garde la vue d’ensemble, prépare, rappelle, repère des tendances et suggère des actions.

L’outil d’IA est votre partenaire dans le tandem — un programme indépendant, qui ne fait pas partie de TandemLoop. Il crée de nouveaux éléments dans votre système, gère les tâches qui lui sont attribuées (assigned_to: ai) et — si vous activez les propositions — suggère des modifications sous forme de propositions.

Comment les agents travaillent avec le dossier de données

Les agents IA lisent le dossier de données comme n’importe quel autre outil — ils parcourent la structure des dossiers, lisent le frontmatter YAML et le corps Markdown. Ce qu’ils peuvent écrire dépend de l’activation des propositions :

Propositions désactivées (par défaut) Propositions activées
Créer de nouveaux éléments : tâches, projets, jalons, domaines, dossiers, vues, tags directement, là où ils ont leur place ; si aucun emplacement n’est évident, une tâche atterrit dans la boîte de réception nouvelles tâches directement dans la boîte de réception, tout le reste sous forme de proposition
Gérer les tâches attribuées (assigned_to: ai) : titre, corps, statut (y compris le retour vers vous), dates et rappel, En attente de, tags, délégation, répétition, valeurs des attributs personnalisés directement directement
Modifier et déplacer l’existant : trier la boîte de réception, compléter des champs, restructurer des projets, ajuster des vues directement ; sur chacune de vos tâches qu’il modifie, il laisse une entrée dans l’Historique sous forme de proposition, que vous examinez et approuvez dans TandemLoop
Supprimer, terminer ou abandonner vos tâches, modifier des specs uniquement sur votre demande expresse ; sans demande, l’agent décrit l’étape dans la conversation ou vous pose une question, et attend votre accord sous forme de proposition

Les tags existants, c’est vous qui les renommez ou les supprimez dans l’app. Indépendamment du réglage, un agent peut créer des attributs personnalisés et des thèmes et, à votre demande, définir un rappel sur n’importe quelle tâche à faire. Dans les deux cas, il est interdit de modifier directement _archive/, _system/, _conflicts/, les réglages de l’app dans _config/ et le bloc géré de AGENTS.md.

À chaque passage, l’agent consigne l’heure dans _config/agent.yaml (last_run). TandemLoop s’en sert pour indiquer sous Retours de l’agent › Chez l’agent quand il a travaillé pour la dernière fois — voir Collaborer de façon autonome et durable.

Activer ou désactiver les propositions

Les propositions sont facultatives et désactivées par défaut. Vous les activez à tout moment dans les réglages :

Réglages › Agents IA › Activer les propositions des agents IA

Ce réglage s’applique à tout le dossier de données. S’il est désactivé, TandemLoop masque toutes les sections consacrées aux propositions ; les fichiers de proposition existants restent intacts et réapparaissent dès que vous réactivez les propositions.

Propositions — les modifications que vous approuvez

Lorsque les propositions sont activées, une proposition est un fichier Markdown dans le dossier _proposals/. Elle décrit une ou plusieurs actions (par exemple « Déplacer la tâche X dans le projet Y ») avec leur justification. Vous pouvez approuver une proposition dans son ensemble ou action par action, la refuser ou la renvoyer pour révision.

Barre latérale › Propositions (en bas) › ouvrir la proposition › Approuver ou Refuser

Pour en savoir plus sur le déroulement des propositions, consultez la partie 4 du manuel.

Attributs personnalisés — créés aussi par les agents

Les attributs personnalisés font partie du modèle de données que les agents connaissent : AGENTS.md et _system/docs/data-model.md listent tous les attributs définis, avec leur clé, leur type, leur portée, leurs options et leur description. L’app met cette liste à jour automatiquement dès que vous créez, modifiez ou supprimez un attribut — ou qu’un agent écrit un nouveau fichier de définition.

Un agent peut ainsi, à votre demande, créer un attribut « Client » pour les tâches, puis le renseigner — directement sans propositions ; avec les propositions, directement dans les éléments qui lui sont attribués et ceux qu’il crée, et via une proposition dans tous les autres (paramètre attributes).

De bonnes descriptions aident : Les agents lisent eux aussi la description d’un attribut. Plus elle explique clairement à quoi sert le champ et comment le renseigner, plus les agents saisissent des valeurs justes.

AGENTS.md — le mode d’emploi pour les agents

Le fichier AGENTS.md se trouve à la racine de votre dossier de données. Il explique les règles du jeu à chaque agent IA : actions autorisées, règles d’écriture, structure des répertoires et — si les propositions sont activées — format des propositions. L’app tient ce fichier à jour et le réécrit en conséquence lorsque vous activez ou désactivez les propositions. Vous pouvez le lire, mais ne modifiez pas à la main le bloc géré par le système entre les marqueurs TANDEMLOOP:START et TANDEMLOOP:END.

Utiliser des agents de l’extérieur : Avant de lancer Claude Code, un autre outil d’IA ou un script sur votre dossier de données, indiquez-lui d’abord AGENTS.md. Des agents bien instruits respectent les règles qui y sont décrites — sans propositions, ils créent de nouveaux éléments et modifient directement l’existant, mais ne suppriment que sur votre demande ; avec les propositions, ils déposent des propositions. Vous gardez ainsi le contrôle total.