Sujets et mode sujet

Un sujet est un fil de travail de longue durée : un problème récurrent, une enquête en cours, un travail qui s'étend sur de nombreuses sessions. Quand le même problème revient, votre agent complète le sujet existant au lieu de créer une nouvelle note : vous disposez ainsi d'un seul endroit qui rassemble tout ce que l'on sait à son propos.

Le tableau Topics : les sujets de type tâche passent de Icebox à Working on puis à Done, et chaque carte affiche sa priorité.

Deux types de sujet

Chaque sujet est soit une tâche (task), soit une information (info) :

• Une tâche est un travail qui a une ligne d'arrivée. Elle a une priorité (de P0 à P3), un statut (icebox, working on, done) avec son historique, et des liens vers les pull requests et les tickets concernés. Les tâches apparaissent sur le tableau.
• Un sujet info est quelque chose que vous suivez, comme un domaine de référence ou des notes que vous rassemblez. Il n'a ni priorité ni statut : il reste donc hors du tableau et apparaît dans sa propre liste.

Un grand projet est un epic de type tâche (voir plus bas), avec des sous-sujets plus petits rangés dessous.

Travailler dans un sujet (mode sujet)

Le mode sujet signifie que votre session travaille dans un sujet donné. Pour commencer, dites à votre agent quelque chose comme « travaillons sur la migration de la facturation » ou « passe en mode sujet sur le nettoyage Sentry ». Votre agent trouve le sujet (et vous demande votre accord avant d'en créer un si aucun ne convient), charge son résumé et en fait le sujet actif de la session. Tant qu'une session est dans un sujet :

• Votre agent se voit rappeler le sujet à chaque prompt, et les enregistrements de ce sujet remontent plus haut quand il cherche dans votre mémoire.
• Les faits et le travail passé enregistrés pendant la session sont classés sous ce sujet.
• Dans Claude Code (dans le terminal) et Oh-My-Pi, la ligne d'état affiche 🎯 <topic title>, et l'efface quand vous quittez le sujet. L'application Claude pour ordinateur ne l'affiche pas. Voir la parité entre harnais d'agent (harness) (en anglais).

Le mode sujet appartient à une seule session : deux sessions dans le même dépôt peuvent chacune travailler sur un sujet différent. Il prend fin quand vous dites en avoir fini avec le sujet (votre agent met alors à jour le résumé du sujet avec ce que la session a accompli) ou quand la session se termine. Une session reprise démarre hors de tout sujet ; demandez à votre agent d'y entrer à nouveau.

Le tableau

La page Topics du tableau de bord présente les sujets de type tâche sous forme de tableau : faites glisser une tâche entre icebox, working on et done, définissez sa priorité et voyez tout le travail en cours d'un coup d'œil. Les sujets info se trouvent dans la liste en dessous, pas sur le tableau.

Votre agent propose de clore une tâche terminée. Quand le travail d'une tâche semble terminé, par exemple quand ses pull requests sont fusionnées, votre agent propose, en une ligne, de la marquer comme terminée. Il ne fait que proposer : c'est à vous de décider de la clore.

Comment les sujets grandissent

Votre agent regroupe les récurrences. Quand quelque chose revient, votre agent l'ajoute au sujet correspondant et incrémente son nombre d'occurrences au lieu de créer un doublon. C'est votre agent qui juge si deux occurrences relèvent du même problème : des incidents liés atterrissent ainsi dans un même fil, même s'ils sont formulés différemment.

Les epics regroupent des fils liés. Un gros chantier, comme la migration de toute une pile de supervision, couvre plusieurs fils plus petits (déplacer les journaux, déplacer les tableaux de bord, déplacer les alertes). Marquez un sujet comme epic et rangez les autres dessous comme sous-sujets. Sur le tableau, l'epic indique combien de sous-sujets il compte et les regroupe, repliables, sous sa carte. Un sous-sujet garde sa propre priorité, son statut et ses liens ; l'imbrication ajoute seulement le parent. L'imbrication ne va pas au-delà d'un niveau.

Les sujets liés se relient latéralement. Quand deux fils sont liés sans que l'un englobe l'autre, reliez-les par « relates to » dans le graphe de connaissances. Le panneau de détail de chaque sujet affiche alors l'autre sous related topics.

Le résumé suit le rythme. Le résumé d'un sujet est ce qu'une nouvelle session lit pour se remettre à niveau. Chaque fois qu'un fait, une action, un document de connaissances ou un lien est classé sous un sujet, votre agent reçoit le résumé actuel du sujet et le nombre d'enregistrements arrivés depuis sa dernière rédaction, et il met le résumé à jour dans le même tour. Incrémenter une récurrence ou déplacer une carte sur le tableau ne modifie pas le résumé.

Sujets et rappel

Les sujets ne sont pas renvoyés par le rappel automatique, qui couvre les faits, les actions passées et les documents de connaissances. Le titre et le statut d'un sujet peuvent être listés à côté du rappel comme fil de travail connexe, et votre agent ouvre le sujet pour le lire.

Outils MCP

• Sujets : create_topic, get_topic, list_topics, update_topic, delete_topic, touch_topic (incrémenter une récurrence), add_topic_tags, remove_topic_tags. Pour ranger un sujet sous un epic, définissez son parentId ; mettez parentId à null pour le ramener au premier niveau. get_topic renvoie le parent, les sous-sujets et les sujets liés.
• Mode sujet : enter_topic, exit_topic, current_topic.
• Sujets liés : link et unlink avec la relation relates_to.

Voir Outils MCP.

Exemple

Le même délai d'attente intermittent réapparaît. Votre agent trouve le sujet existant et l'incrémente au lieu d'ouvrir une sixième note : le fil indique désormais « vu 6 fois », avec l'enquête précédente, la pull request qui l'a à moitié corrigé et le ticket toujours ouvert, le tout au même endroit, que vous pouvez prioriser sur le tableau.

Voir aussi

• Garder un travail dans un sujet : le tutoriel pas à pas.
• Le tableau de bord : là où se trouve le tableau.
• Le graphe de connaissances : relier un sujet à des travaux connexes.