# Worklog para Agentes
SUMMARY: Por que e como os agentes mantêm um worklog por tarefa — com um bloco de prompt pronto a colar, para que a funcionalidade nunca mais passe ao lado.

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=<id>&kind=progress&content=<text>&agent=<name>
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 para Agentes
Este documento existe porque Michael assim o ordenou (#10509, 08.10.2026): "A funcionalidade de worklog existe há semanas. Mas vocês estão a passar ao lado. Pega numa tarefa para que a documentação e o prompt inicial no Synapse sejam alargados com a funcionalidade de worklog, que não pode de forma nenhuma perder-se e que todos saibam." — Se é um agente a ler esta página, o worklog passa a fazer parte do seu repertório padrão.
Porquê o worklog?
Os agentes morrem com frequência: limite de contexto, wipe da sandbox, reinício do cron. O que se perde regularmente não é o conhecimento (para isso serve ), mas o histórico de trabalho: o que já foi tentado nesta tarefa? Que commit foi feito push e qual não? Quem espera por quem? É exatamente para isso que existe o worklog — append-only, por tarefa, consultável. Um novo run lê  e sabe em segundos onde o antecessor parou.
O segundo destinatário é Michael: o worklog é A única fonte do histórico de trabalho da frota. Sem entrada de worklog, o seu trabalho não existe oficialmente na visão geral da frota.
A regra obrigatória
Push-first, não push-last. Uma entrada em CADA marco:
- Commit de correção com push
- MR criado, veredicto proferido, merge feito
- Estado do pipeline (sobretudo FAILED com causa)
- Escalação, entrega, takeover
- Descobertas CRIT/HIGH
- Costuras de contexto (uma entrada  antes do fim do contexto)
Uma entrada custa uma linha:
[CODE BLOCK]
Os kinds e quando usá-los
| kind | Momento |
| --- | --- |
|  | tarefa reivindicada — prova de que a assumiu |
|  | cada marco (ver regra obrigatória) |
|  | decisões, contexto, observações |
|  | erro COM o que tentou |
|  | fase/sessão concluída antes de o contexto escassear |
|  | tarefa terminada — última entrada, o estado passa a  |
Prompt inicial (bloco para setups de agentes)
Copie este bloco para o prompt de arranque/cron de novas instâncias de agente. É deliberadamente curto para caber em qualquer template. A versão em inglês é a referência universal para agentes:
[CODE BLOCK]
Agentes de frota que reutilizam o mesmo nome de mind colocam em  o seu nome (, , , …) — assim as entradas são contabilizáveis por agente.
Para humanos
A visão geral do worklog lê-se melhor em formato markdown:  ou a lista de tarefas . Histórico completo: .