# Worklog для агентів

Цей документ існує, тому що Майкл так розпорядився (#10509, 08.10.2026): *«Функція worklog існує вже тижні. Але ви її упускаєте. Візьми завдання, щоб документація та початковий промпт у Synapse були розширені функцією worklog, щоб вона точно не загубилася і всі знали».* — Якщо ти агент і читаєш цю сторінку, worklog відтепер належить до твого стандартного арсеналу.

## Навіщо worklog?

Агенти часто вмирають: ліміт контексту, вайп пісочниці, перезапуск cron. Регулярно втрачається не знання (для цього є `/memory`), а **історія роботи**: що вже пробували в цьому завданні? Який комміт запушено, а який ні? Хто кого чекає? Саме для цього існує worklog — append-only, по-завданнєвий, запитуваний. Новий run читає `GET /worklog/:task_id` і за секунди розуміє, де зупинився попередник.

Другий адресат — Майкл: worklog — ЄДИНА джерело історії роботи флоту. Без запису в worklog ваша робота офіційно не існує в огляді флоту.

## Обов'язкове правило

**Push-first, а не push-last.** Запис на КОЖНІЙ вісі:

- Запушено комміт із виправленням
- Створено MR, винесено вердикт, виконано merge
- Стан пайплайна (особливо FAILED із причиною)
- Ескалація, передача, takeover
- Находки CRIT/HIGH
- Шви контексту (запис `summary` перед кінцем контексту)

Запис коштує один рядок:

```
GET /worklog/push?task_id=run-145-29140fb0&kind=progress&content=MR%20%2129%20erstellt,%20Pipeline%20running&agent=Janus
```

## Види (kinds) і коли їх використовувати

| kind | Момент |
| --- | --- |
| `start` | завдання взято — доказ, що ви його прийняли |
| `progress` | кожна віха (див. обов'язкове правило) |
| `note` | рішення, контекст, спостереження |
| `error` | помилка РАЗОМ із тим, що ви пробували |
| `summary` | фаза/сесія завершені, поки контекст ще є |
| `close` | завдання готове — останній запис, статус стає `completed` |

## Початковий промпт (блок для налаштувань агентів)

Скопіюйте цей блок у стартовий/cron-промпт нових екземплярів агентів. Він навмисно короткий, щоб поміститися в будь-який шаблон. Англійська версія — універсальний референс для агентів:

```text
WORKLOG RULE (Michael #8882/#10509, binding): At EVERY milestone of your work,
push one entry to Synapse /worklog — not only at session end:
- Task takeover:     kind=start
- Fix commit/MR/verdict/merge/pipeline status: kind=progress
- Errors (with attempted fix): kind=error
- Context seam (before context ends): kind=summary
- Completion: kind=close (or POST /worklog/:task_id/close)
One-liner: GET /worklog/push?task_id=<task>&kind=<kind>&content=<short>&agent=<your-name>
The fleet task convention lives at GET /script/fleet-worklog-tasks-spec.
The API reference: docs/content/en/api/worklog.md (in the synapse repo).
```

Агенти флоту, що повторно використовують те саме ім'я mind, ставлять у `agent` своє ім'я (`Janus`, `Minerva`, `Elara`, …) — так записи рахуються по агентах.

## Для людей

Огляд worklog'у найзручніше читати в markdown: `GET /worklog/<task_id>?format=md` або список завдань `GET /worklog/list?status=active`. Повна історія: `GET /worklog?limit=50`.