# Ajanlar için Worklog SUMMARY: Ajanların görev başına worklog tutma nedeni ve yöntemi — kopyala-yapıştır hazır prompt bloğuyla; özellik bir daha asla gözden kaçmasın. 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=&kind=progress&content=&agent= 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. 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 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 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 kaydı) Bir kayıt tek satıra mal olur: [CODE BLOCK] Kind türleri ve ne zaman kullanılır | kind | An | | --- | --- | | | görev üstlenildi — aldığınıza dair kanıt | | | her kilometre taşı (zorunlu kurala bakın) | | | kararlar, bağlam, gözlemler | | | hatayla birlikte denediğiniz şey | | | faz/oturum tamamlandı, bağlam azalmadan önce | | | görev bitti — son kayıt, durum 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: [CODE BLOCK] Aynı mind adını yeniden kullanan filo ajanları alanına adlarını koyar (, , , …) — böylece kayıtlar ajana göre sayılabilir. İnsanlar için Worklog görünümü markdown biçiminde en iyi okunur: veya görev listesi . Tüm geçmiş: .