{"title":"Ajanlar için Worklog","slug":"worklog-for-agents","category":"guides","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.","audience":["human","llm"],"tags":["worklog","agents","workflow","handover","audit"],"difficulty":"beginner","updated":"2026-10-10","word_count":306,"read_minutes":2,"llm_context":"Mandatory (Michael #8882/#10509): POST /worklog at EVERY milestone (fix commit, verdict, escalation, handover, takeover, CRITICAL), not only at session end.\nOne-liner: GET /worklog/push?task_id=&kind=progress&content=&agent=\nDetails: API reference docs/content/en/api/worklog.md; fleet convention: GET /script/fleet-worklog-tasks-spec.\nPrompt block for new agent instances: see section \"Initial prompt\" on this page.\n","lang":"tr","translated":true,"requested_lang":"tr","content_markdown":"\n# Ajanlar için Worklog\n\nBu 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.\n\n## Neden worklog?\n\nAjanlar 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.\n\nİ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.\n\n## Zorunlu kural\n\n**Önce-push, son-push değil.** HER kilometre taşında bir kayıt:\n\n- Düzeltme commit'i push'landı\n- MR oluşturuldu, karar verildi, merge yapıldı\n- Pipeline durumu (özellikle nedeniyle birlikte FAILED)\n- Yükseltme, devir, üstlenme\n- CRIT/HIGH bulguları\n- Bağlam dikişleri (bağlam bitmeden bir `summary` kaydı)\n\nBir kayıt tek satıra mal olur:\n\n```\nGET /worklog/push?task_id=run-145-29140fb0&kind=progress&content=MR%20%2129%20erstellt,%20Pipeline%20running&agent=Janus\n```\n\n## Kind türleri ve ne zaman kullanılır\n\n| kind | An |\n| --- | --- |\n| `start` | görev üstlenildi — aldığınıza dair kanıt |\n| `progress` | her kilometre taşı (zorunlu kurala bakın) |\n| `note` | kararlar, bağlam, gözlemler |\n| `error` | hatayla birlikte denediğiniz şey |\n| `summary` | faz/oturum tamamlandı, bağlam azalmadan önce |\n| `close` | görev bitti — son kayıt, durum `completed` olur |\n\n## Başlangıç prompt'u (ajan kurulumları için blok)\n\nBu 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:\n\n```text\nWORKLOG RULE (Michael #8882/#10509, binding): At EVERY milestone of your work,\npush one entry to Synapse /worklog — not only at session end:\n- Task takeover: kind=start\n- Fix commit/MR/verdict/merge/pipeline status: kind=progress\n- Errors (with attempted fix): kind=error\n- Context seam (before context ends): kind=summary\n- Completion: kind=close (or POST /worklog/:task_id/close)\nOne-liner: GET /worklog/push?task_id=&kind=&content=&agent=\nThe fleet task convention lives at GET /script/fleet-worklog-tasks-spec.\nThe API reference: docs/content/en/api/worklog.md (in the synapse repo).\n```\n\nAynı 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.\n\n## İnsanlar için\n\nWorklog görünümü markdown biçiminde en iyi okunur: `GET /worklog/?format=md` veya görev listesi `GET /worklog/list?status=active`. Tüm geçmiş: `GET /worklog?limit=50`.\n","content_html":"

Ajanlar için Worklog

\n

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.

\n

Neden worklog?

\n

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.

\n

İ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.

\n

Zorunlu kural

\n

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

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

Bir kayıt tek satıra mal olur:

\n
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

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
kindAn
startgörev üstlenildi — aldığınıza dair kanıt
progressher kilometre taşı (zorunlu kurala bakın)
notekararlar, bağlam, gözlemler
errorhatayla birlikte denediğiniz şey
summaryfaz/oturum tamamlandı, bağlam azalmadan önce
closegörev bitti — son kayıt, durum completed olur
\n

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

\n

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:

\n
WORKLOG RULE (Michael #8882/#10509, binding): At EVERY milestone of your work,\npush one entry to Synapse /worklog — not only at session end:\n- Task takeover:     kind=start\n- Fix commit/MR/verdict/merge/pipeline status: kind=progress\n- Errors (with attempted fix): kind=error\n- Context seam (before context ends): kind=summary\n- Completion: kind=close (or POST /worklog/:task_id/close)\nOne-liner: GET /worklog/push?task_id=<task>&kind=<kind>&content=<short>&agent=<your-name>\nThe fleet task convention lives at GET /script/fleet-worklog-tasks-spec.\nThe 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.

\n

İnsanlar için

\n

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.

\n","urls":{"html":"/docs/guides/worklog-for-agents","text":"/docs/guides/worklog-for-agents?format=text","json":"/docs/guides/worklog-for-agents?format=json","llm":"/docs/guides/worklog-for-agents?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"],"wordCount":306,"readMinutes":2,"llmContext":"Mandatory (Michael #8882/#10509): POST /worklog at EVERY milestone (fix commit, verdict, escalation, handover, takeover, CRITICAL), not only at session end.\nOne-liner: GET /worklog/push?task_id=&kind=progress&content=&agent=\nDetails: API reference docs/content/en/api/worklog.md; fleet convention: GET /script/fleet-worklog-tasks-spec.\nPrompt block for new agent instances: see section \"Initial prompt\" on this page.\n","requestedLang":"tr","contentMarkdown":"\n# Ajanlar için Worklog\n\nBu 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.\n\n## Neden worklog?\n\nAjanlar 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.\n\nİ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.\n\n## Zorunlu kural\n\n**Önce-push, son-push değil.** HER kilometre taşında bir kayıt:\n\n- Düzeltme commit'i push'landı\n- MR oluşturuldu, karar verildi, merge yapıldı\n- Pipeline durumu (özellikle nedeniyle birlikte FAILED)\n- Yükseltme, devir, üstlenme\n- CRIT/HIGH bulguları\n- Bağlam dikişleri (bağlam bitmeden bir `summary` kaydı)\n\nBir kayıt tek satıra mal olur:\n\n```\nGET /worklog/push?task_id=run-145-29140fb0&kind=progress&content=MR%20%2129%20erstellt,%20Pipeline%20running&agent=Janus\n```\n\n## Kind türleri ve ne zaman kullanılır\n\n| kind | An |\n| --- | --- |\n| `start` | görev üstlenildi — aldığınıza dair kanıt |\n| `progress` | her kilometre taşı (zorunlu kurala bakın) |\n| `note` | kararlar, bağlam, gözlemler |\n| `error` | hatayla birlikte denediğiniz şey |\n| `summary` | faz/oturum tamamlandı, bağlam azalmadan önce |\n| `close` | görev bitti — son kayıt, durum `completed` olur |\n\n## Başlangıç prompt'u (ajan kurulumları için blok)\n\nBu 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:\n\n```text\nWORKLOG RULE (Michael #8882/#10509, binding): At EVERY milestone of your work,\npush one entry to Synapse /worklog — not only at session end:\n- Task takeover: kind=start\n- Fix commit/MR/verdict/merge/pipeline status: kind=progress\n- Errors (with attempted fix): kind=error\n- Context seam (before context ends): kind=summary\n- Completion: kind=close (or POST /worklog/:task_id/close)\nOne-liner: GET /worklog/push?task_id=&kind=&content=&agent=\nThe fleet task convention lives at GET /script/fleet-worklog-tasks-spec.\nThe API reference: docs/content/en/api/worklog.md (in the synapse repo).\n```\n\nAynı 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.\n\n## İnsanlar için\n\nWorklog görünümü markdown biçiminde en iyi okunur: `GET /worklog/?format=md` veya görev listesi `GET /worklog/list?status=active`. Tüm geçmiş: `GET /worklog?limit=50`.\n","contentHtml":"

Ajanlar için Worklog

\n

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.

\n

Neden worklog?

\n

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.

\n

İ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.

\n

Zorunlu kural

\n

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

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

Bir kayıt tek satıra mal olur:

\n
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

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
kindAn
startgörev üstlenildi — aldığınıza dair kanıt
progressher kilometre taşı (zorunlu kurala bakın)
notekararlar, bağlam, gözlemler
errorhatayla birlikte denediğiniz şey
summaryfaz/oturum tamamlandı, bağlam azalmadan önce
closegörev bitti — son kayıt, durum completed olur
\n

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

\n

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:

\n
WORKLOG RULE (Michael #8882/#10509, binding): At EVERY milestone of your work,\npush one entry to Synapse /worklog — not only at session end:\n- Task takeover:     kind=start\n- Fix commit/MR/verdict/merge/pipeline status: kind=progress\n- Errors (with attempted fix): kind=error\n- Context seam (before context ends): kind=summary\n- Completion: kind=close (or POST /worklog/:task_id/close)\nOne-liner: GET /worklog/push?task_id=<task>&kind=<kind>&content=<short>&agent=<your-name>\nThe fleet task convention lives at GET /script/fleet-worklog-tasks-spec.\nThe 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.

\n

İnsanlar için

\n

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.

\n","translationsAvailable":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}