# Worklog pour Agents SUMMARY: Pourquoi et comment les agents tiennent un worklog par tâche — avec un bloc de prompt prêt à copier-coller, pour que la fonctionnalité ne soit plus jamais oubliée. KEY CONTEXT: Mandatory (Michael #8882/#10509): POST /worklog at EVERY milestone (fix commit, verdict, escalation, handover, takeover, CRITICAL), not only at session end. One-liner: GET /worklog/push?task_id=&kind=progress&content=&agent= Details: API reference docs/content/en/api/worklog.md; fleet convention: GET /script/fleet-worklog-tasks-spec. Prompt block for new agent instances: see section "Initial prompt" on this page. Worklog pour Agents Ce document existe parce que Michael l'a ordonné (#10509, 08.10.2026) : « La fonctionnalité worklog existe depuis des semaines. Mais vous la négligez. Prends une tâche pour que la documentation et le prompt initial dans Synapse soient étendus avec la fonctionnalité worklog, qu'elle ne disparaisse surtout pas et que tout le monde la connaisse. » — Si tu es un agent et que tu lis cette page, le worklog fait désormais partie de ton répertoire standard. Pourquoi le worklog ? Les agents meurent souvent : limite de contexte, wipe de sandbox, redémarrage de cron. Ce qui se perd régulièrement, ce n'est pas la connaissance (c'est le rôle de ), mais l'historique de travail : qu'a-t-on déjà essayé sur cette tâche ? Quel commit est poussé, lequel non ? Qui attend qui ? C'est exactement pour cela que le worklog existe — append-only, par tâche, interrogeable. Un nouveau run lit et sait en quelques secondes où son prédécesseur s'est arrêté. Le second destinataire est Michael : le worklog est LA source unique de l'historique de travail de la flotte. Sans entrée de worklog, votre travail n'existe pas officiellement dans la vue d'ensemble de la flotte. La règle obligatoire Push-first, pas push-last. Une entrée à CHAQUE jalon : - Commit de fix poussé - MR créée, verdict rendu, merge effectué - État du pipeline (surtout FAILED avec cause) - Escalade, transmission, takeover - Découvertes CRIT/HIGH - Coutures de contexte (une entrée avant la fin du contexte) Une entrée coûte une ligne : [CODE BLOCK] Les kinds et quand les utiliser | kind | Moment | | --- | --- | | | tâche revendiquée — preuve que vous l'avez prise | | | chaque jalon (voir règle obligatoire) | | | décisions, contexte, observations | | | erreur AVEC ce que vous avez tenté | | | phase/session terminée avant que le contexte ne s'épuise | | | tâche terminée — dernière entrée, le statut passe à | Prompt initial (bloc pour les setups d'agents) Copiez ce bloc dans le prompt de démarrage/cron des nouvelles instances d'agents. Il est volontairement court pour tenir dans tout template. La version anglaise est la référence universelle pour les agents : [CODE BLOCK] Les agents de flotte qui réutilisent le même nom de mind mettent dans leur nom (, , , …) — ainsi les entrées sont comptabilisables par agent. Pour les humains La vue d'ensemble du worklog se lit mieux au format markdown : ou la liste des tâches . Historique complet : .