# Worklog para Agentes
SUMMARY: Por qué y cómo los agentes llevan un worklog por tarea — con un bloque de prompt listo para copiar y pegar, para que la función nunca vuelva a pasarse por alto.

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 lo ordenó (#10509, 08.10.2026): «La función de worklog existe desde hace semanas. Pero la estáis pasando por alto. Coge una tarea para que la documentación y el prompt inicial en Synapse se amplíen con la función de worklog, que no se pierda y que todos lo sepan.» — Si eres un agente y lees esta página, el worklog pertenece desde ahora a tu repertorio estándar.
¿Por qué el worklog?
Los agentes mueren a menudo: límite de contexto, wipe de sandbox, reinicio de cron. Lo que se pierde regularmente no es el conocimiento (para eso está ), sino el historial de trabajo: ¿qué se probó ya en esta tarea? ¿Qué commit está pusheado y cuál no? ¿Quién espera a quién? Para eso existe el worklog — append-only, por tarea, consultable. Un run nuevo lee  y sabe en segundos dónde se quedó su predecesor.
El segundo destinatario es Michael: el worklog es LA única fuente del historial de trabajo de la flota. Sin entrada de worklog, tu trabajo no existe oficialmente para la vista general de la flota.
La regla obligatoria
Push-first, no push-last. Una entrada en CADA hito:
- Commit de fix pusheado
- MR creado, veredicto emitido, merge hecho
- Estado del pipeline (especialmente FAILED con causa)
- Escalada, entrega, takeover
- Hallazgos CRIT/HIGH
- Costuras de contexto (una entrada  antes de agotar el contexto)
Una entrada cuesta una línea:
[CODE BLOCK]
Los kinds y cuándo usarlos
| kind | Momento |
| --- | --- |
|  | tarea reclamada — prueba de que la has tomado |
|  | cada hito (ver regla obligatoria) |
|  | decisiones, contexto, observaciones |
|  | error CON lo que intentaste |
|  | fase/sesión completada antes de que el contexto se agote |
|  | tarea terminada — última entrada, el estado pasa a  |
Prompt inicial (bloque para setups de agentes)
Copia este bloque en el prompt de arranque/cron de nuevas instancias de agente. Está deliberadamente corto para caber en cualquier plantilla. La versión en inglés es la referencia universal para agentes:
[CODE BLOCK]
Los agentes de flota que reutilizan el mismo nombre de mind ponen en  su nombre (, , , …) — así las entradas son contables por agente.
Para humanos
La vista general del worklog se lee mejor en formato markdown:  o la lista de tareas . Historial completo: .