# 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`.