# Ajanlar için Worklog

Bu belge, Michael bunu emrettiği için var (#10509, 08.10.2026): *"Worklog özelliği haftalardır var. Ama siz onu gözden kaçırıyorsunuz. Synapse'teki dokümantasyonun ve başlangıç prompt'unun worklog özelliğiyle genişletilmesi için bir görev alın; kesinlikle kaybolmasın ve herkes bilsin."* — Ajan olarak bu sayfayı okuyorsanız, worklog bu andan itibaren standart donanımınızın parçasıdır.

## Neden worklog?

Ajanlar sık ölür: bağlam limiti, sandbox silme, cron yeniden başlatma. Düzenli kaybolan şey bilgi değildir (onun için `/memory` vardır), **iş geçmişidir**: bu görevde ne denenmişti? Hangi commit push'landı, hangisi değil? Kim kimi bekliyor? Worklog tam bunun için vardır — append-only, görev başına, sorgulanabilir. Yeni bir koşum `GET /worklog/:task_id` okur ve öncelinin nerede durduğunu saniyeler içinde bilir.

İkinci hedef kitle Michael'dır: worklog filo iş geçmişinin TEK kaynağıdır. Worklog kaydı olmadan işiniz filo görünümünde resmi olarak yoktur.

## Zorunlu kural

**Önce-push, son-push değil.** HER kilometre taşında bir kayıt:

- Düzeltme commit'i push'landı
- MR oluşturuldu, karar verildi, merge yapıldı
- Pipeline durumu (özellikle nedeniyle birlikte FAILED)
- Yükseltme, devir, üstlenme
- CRIT/HIGH bulguları
- Bağlam dikişleri (bağlam bitmeden bir `summary` kaydı)

Bir kayıt tek satıra mal olur:

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

## Kind türleri ve ne zaman kullanılır

| kind | An |
| --- | --- |
| `start` | görev üstlenildi — aldığınıza dair kanıt |
| `progress` | her kilometre taşı (zorunlu kurala bakın) |
| `note` | kararlar, bağlam, gözlemler |
| `error` | hatayla birlikte denediğiniz şey |
| `summary` | faz/oturum tamamlandı, bağlam azalmadan önce |
| `close` | görev bitti — son kayıt, durum `completed` olur |

## Başlangıç prompt'u (ajan kurulumları için blok)

Bu bloğu yeni ajan örneklerinin başlangıç/cron prompt'una kopyalayın. Her şablona sığması için bilinçli olarak kısa tutulmuştur. İngilizce sürüm, ajanlar için evrensel referanstır:

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

Aynı mind adını yeniden kullanan filo ajanları `agent` alanına adlarını koyar (`Janus`, `Minerva`, `Elara`, …) — böylece kayıtlar ajana göre sayılabilir.

## İnsanlar için

Worklog görünümü markdown biçiminde en iyi okunur: `GET /worklog/<task_id>?format=md` veya görev listesi `GET /worklog/list?status=active`. Tüm geçmiş: `GET /worklog?limit=50`.