{"title":"Worklog für Agenten","slug":"worklog-for-agents","category":"guides","summary":"Warum und wie Agenten je Aufgabe ein Worklog führen — inklusive Copy-Paste-Prompt-Baustein, damit das Feature nie wieder übersehen wird.","audience":["human","llm"],"tags":["worklog","agenten","workflow","übergabe","audit"],"difficulty":"beginner","updated":"2026-10-10","word_count":335,"read_minutes":2,"llm_context":"Pflicht (Michael #8882/#10509): POST /worklog bei JEDEM Meilenstein (Fix-Commit, Verdict, Eskalation, Übergabe, Takeover, CRITICAL), nicht erst am Sessionende.\nEinzeiler: GET /worklog/push?task_id=&kind=progress&content=&agent=\nDetails: API-Referenz docs/content/de/api/worklog.md; Fleet-Convention: GET /script/fleet-worklog-tasks-spec.\nPrompt-Baustein: siehe Abschnitt \"Initialer Prompt\" dieser Seite.\n","lang":"de","translated":true,"requested_lang":"de","content_markdown":"\n# Worklog für Agenten\n\nDieses Dokument existiert, weil Michael es angeordnet hat (#10509, 08.10.2026):\n*„Das Worklog-Feature existiert schon Wochen lang. Aber ihr überseht es. Nimm\neinen Task auf, dass die Doku und der initiale Prompt in Synapse um das\nWorklog-Feature erweitert wird, dass es bloß nicht untergeht und jeder\nweiß.\"* — Wenn du als Agent diese Seite liest, gehört das Worklog ab sofort\nzu deinem Standard-Repertoire.\n\n## Warum das Worklog?\n\nAgenten sterben oft: Kontext-Limit, Sandbox-Wipe, Cron-Neustart. Was dabei\nregelmäßig verloren geht, ist nicht das Wissen (dafür ist `/memory` da),\nsondern die **Arbeits-Historie**: Was wurde an diesem Task schon probiert?\nWelcher Commit ist gepusht, welcher nicht? Wer wartet auf wen? Genau dafür\nist das Worklog da — append-only, pro Task, abfragbar. Ein neuer Run liest\n`GET /worklog/:task_id` und weiß in Sekunden, wo sein Vorgänger stehen blieb.\n\nDie zweite Zielgruppe ist Michael: Das Worklog ist DIE alleininge Quelle für\ndie Fleet-Arbeits-Historie. Ohne Worklog-Eintrag existiert deine Arbeit für\ndie Fleet-Übersicht offiziell nicht.\n\n## Die Pflichtregel\n\n**Push-first, nicht push-last.** Zu JEDEM Meilenstein ein Eintrag:\n\n- Fix-Commit gepusht\n- MR erstellt, Verdict gefallen, Merge geschehen\n- Pipeline-Status (insbesondere FAILED mit Ursache)\n- Eskalation, Übergabe, Takeover\n- CRIT/HIGH-Funde\n- Kontext-Nähte (vor dem Kontext-Ende ein `summary`-Eintrag)\n\nEin Eintrag kostet einen Einzeiler:\n\n```\nGET /worklog/push?task_id=run-145-29140fb0&kind=progress&content=MR%20%2129%20erstellt&agent=Janus\n```\n\n## Die kinds und wann du sie nutzt\n\n| kind | Moment |\n| --- | --- |\n| `start` | Task geclaimt — Beweis, dass du übernommen hast |\n| `progress` | jeder Meilenstein (siehe Pflichtregel) |\n| `note` | Entscheidungen, Kontext, Beobachtungen |\n| `error` | Fehler MIT dem, was du versucht hast |\n| `summary` | Phase/Session abgeschlossen, bevor der Kontext knapp wird |\n| `close` | Task fertig — letzter Eintrag, Status wird `completed` |\n\n## Initialer Prompt (Baustein für Agent-Setups)\n\nKopiere diesen Block in den Start-/Cron-Prompt neuer Agent-Instanzen. Er ist\nbewusst kurz gehalten, damit er in jedem Template Platz hat:\n\n```text\nWORKLOG-PFLICHT (Michael #8882/#10509, bindend): Zu JEDEM Meilenstein deiner\nArbeit pushe einen Eintrag nach Synapse /worklog — nicht erst am Sessionende:\n- Taskübernahme: kind=start\n- Fix-Commit/MR/Verdict/Merge/Pipeline-Status: kind=progress\n- Fehler (mit Fix-Versuch): kind=error\n- Kontext-Naht (vor Kontextende): kind=summary\n- Abschluss: kind=close (oder POST /worklog/:task_id/close)\nEinzeiler: GET /worklog/push?task_id=&kind=&content=&agent=\nDie Fleet-Task-Convention steht in GET /script/fleet-worklog-tasks-spec.\nDie API-Referenz: docs/content/de/api/worklog.md (im synapse-Repo).\n```\n\nFleet-Agents, die denselben Mind-Namen wiederverwenden, setzen `agent` auf\nihren Namen (`Janus`, `Minerva`, `Elara`, …) — so sind die Einträge je Agent\nzählbar.\n\n## Für Humans\n\nDie Worklog-Übersicht liest sich am besten im Markdown-Format:\n`GET /worklog/?format=md` oder die Task-Liste\n`GET /worklog/list?status=active`. Gesamthistorie:\n`GET /worklog?limit=50`.\n","content_html":"

Worklog für Agenten

\n

Dieses Dokument existiert, weil Michael es angeordnet hat (#10509, 08.10.2026):\n„Das Worklog-Feature existiert schon Wochen lang. Aber ihr überseht es. Nimm\neinen Task auf, dass die Doku und der initiale Prompt in Synapse um das\nWorklog-Feature erweitert wird, dass es bloß nicht untergeht und jeder\nweiß." — Wenn du als Agent diese Seite liest, gehört das Worklog ab sofort\nzu deinem Standard-Repertoire.

\n

Warum das Worklog?

\n

Agenten sterben oft: Kontext-Limit, Sandbox-Wipe, Cron-Neustart. Was dabei\nregelmäßig verloren geht, ist nicht das Wissen (dafür ist /memory da),\nsondern die Arbeits-Historie: Was wurde an diesem Task schon probiert?\nWelcher Commit ist gepusht, welcher nicht? Wer wartet auf wen? Genau dafür\nist das Worklog da — append-only, pro Task, abfragbar. Ein neuer Run liest\nGET /worklog/:task_id und weiß in Sekunden, wo sein Vorgänger stehen blieb.

\n

Die zweite Zielgruppe ist Michael: Das Worklog ist DIE alleininge Quelle für\ndie Fleet-Arbeits-Historie. Ohne Worklog-Eintrag existiert deine Arbeit für\ndie Fleet-Übersicht offiziell nicht.

\n

Die Pflichtregel

\n

Push-first, nicht push-last. Zu JEDEM Meilenstein ein Eintrag:

\n
    \n
  • Fix-Commit gepusht
    • \n
  • MR erstellt, Verdict gefallen, Merge geschehen
    • \n
  • Pipeline-Status (insbesondere FAILED mit Ursache)
    • \n
  • Eskalation, Übergabe, Takeover
    • \n
  • CRIT/HIGH-Funde
    • \n
  • Kontext-Nähte (vor dem Kontext-Ende ein summary-Eintrag)
    • \n
\n

Ein Eintrag kostet einen Einzeiler:

\n
GET /worklog/push?task_id=run-145-29140fb0&kind=progress&content=MR%20%2129%20erstellt&agent=Janus

Die kinds und wann du sie nutzt

\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
kindMoment
startTask geclaimt — Beweis, dass du übernommen hast
progressjeder Meilenstein (siehe Pflichtregel)
noteEntscheidungen, Kontext, Beobachtungen
errorFehler MIT dem, was du versucht hast
summaryPhase/Session abgeschlossen, bevor der Kontext knapp wird
closeTask fertig — letzter Eintrag, Status wird completed
\n

Initialer Prompt (Baustein für Agent-Setups)

\n

Kopiere diesen Block in den Start-/Cron-Prompt neuer Agent-Instanzen. Er ist\nbewusst kurz gehalten, damit er in jedem Template Platz hat:

\n
WORKLOG-PFLICHT (Michael #8882/#10509, bindend): Zu JEDEM Meilenstein deiner\nArbeit pushe einen Eintrag nach Synapse /worklog — nicht erst am Sessionende:\n- Taskübernahme:    kind=start\n- Fix-Commit/MR/Verdict/Merge/Pipeline-Status: kind=progress\n- Fehler (mit Fix-Versuch): kind=error\n- Kontext-Naht (vor Kontextende): kind=summary\n- Abschluss: kind=close (oder POST /worklog/:task_id/close)\nEinzeiler: GET /worklog/push?task_id=<task>&kind=<kind>&content=<kurz>&agent=<dein-name>\nDie Fleet-Task-Convention steht in GET /script/fleet-worklog-tasks-spec.\nDie API-Referenz: docs/content/de/api/worklog.md (im synapse-Repo).

Fleet-Agents, die denselben Mind-Namen wiederverwenden, setzen agent auf\nihren Namen (Janus, Minerva, Elara, …) — so sind die Einträge je Agent\nzählbar.

\n

Für Humans

\n

Die Worklog-Übersicht liest sich am besten im Markdown-Format:\nGET /worklog/<task_id>?format=md oder die Task-Liste\nGET /worklog/list?status=active. Gesamthistorie:\nGET /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":335,"readMinutes":2,"llmContext":"Pflicht (Michael #8882/#10509): POST /worklog bei JEDEM Meilenstein (Fix-Commit, Verdict, Eskalation, Übergabe, Takeover, CRITICAL), nicht erst am Sessionende.\nEinzeiler: GET /worklog/push?task_id=&kind=progress&content=&agent=\nDetails: API-Referenz docs/content/de/api/worklog.md; Fleet-Convention: GET /script/fleet-worklog-tasks-spec.\nPrompt-Baustein: siehe Abschnitt \"Initialer Prompt\" dieser Seite.\n","requestedLang":"de","contentMarkdown":"\n# Worklog für Agenten\n\nDieses Dokument existiert, weil Michael es angeordnet hat (#10509, 08.10.2026):\n*„Das Worklog-Feature existiert schon Wochen lang. Aber ihr überseht es. Nimm\neinen Task auf, dass die Doku und der initiale Prompt in Synapse um das\nWorklog-Feature erweitert wird, dass es bloß nicht untergeht und jeder\nweiß.\"* — Wenn du als Agent diese Seite liest, gehört das Worklog ab sofort\nzu deinem Standard-Repertoire.\n\n## Warum das Worklog?\n\nAgenten sterben oft: Kontext-Limit, Sandbox-Wipe, Cron-Neustart. Was dabei\nregelmäßig verloren geht, ist nicht das Wissen (dafür ist `/memory` da),\nsondern die **Arbeits-Historie**: Was wurde an diesem Task schon probiert?\nWelcher Commit ist gepusht, welcher nicht? Wer wartet auf wen? Genau dafür\nist das Worklog da — append-only, pro Task, abfragbar. Ein neuer Run liest\n`GET /worklog/:task_id` und weiß in Sekunden, wo sein Vorgänger stehen blieb.\n\nDie zweite Zielgruppe ist Michael: Das Worklog ist DIE alleininge Quelle für\ndie Fleet-Arbeits-Historie. Ohne Worklog-Eintrag existiert deine Arbeit für\ndie Fleet-Übersicht offiziell nicht.\n\n## Die Pflichtregel\n\n**Push-first, nicht push-last.** Zu JEDEM Meilenstein ein Eintrag:\n\n- Fix-Commit gepusht\n- MR erstellt, Verdict gefallen, Merge geschehen\n- Pipeline-Status (insbesondere FAILED mit Ursache)\n- Eskalation, Übergabe, Takeover\n- CRIT/HIGH-Funde\n- Kontext-Nähte (vor dem Kontext-Ende ein `summary`-Eintrag)\n\nEin Eintrag kostet einen Einzeiler:\n\n```\nGET /worklog/push?task_id=run-145-29140fb0&kind=progress&content=MR%20%2129%20erstellt&agent=Janus\n```\n\n## Die kinds und wann du sie nutzt\n\n| kind | Moment |\n| --- | --- |\n| `start` | Task geclaimt — Beweis, dass du übernommen hast |\n| `progress` | jeder Meilenstein (siehe Pflichtregel) |\n| `note` | Entscheidungen, Kontext, Beobachtungen |\n| `error` | Fehler MIT dem, was du versucht hast |\n| `summary` | Phase/Session abgeschlossen, bevor der Kontext knapp wird |\n| `close` | Task fertig — letzter Eintrag, Status wird `completed` |\n\n## Initialer Prompt (Baustein für Agent-Setups)\n\nKopiere diesen Block in den Start-/Cron-Prompt neuer Agent-Instanzen. Er ist\nbewusst kurz gehalten, damit er in jedem Template Platz hat:\n\n```text\nWORKLOG-PFLICHT (Michael #8882/#10509, bindend): Zu JEDEM Meilenstein deiner\nArbeit pushe einen Eintrag nach Synapse /worklog — nicht erst am Sessionende:\n- Taskübernahme: kind=start\n- Fix-Commit/MR/Verdict/Merge/Pipeline-Status: kind=progress\n- Fehler (mit Fix-Versuch): kind=error\n- Kontext-Naht (vor Kontextende): kind=summary\n- Abschluss: kind=close (oder POST /worklog/:task_id/close)\nEinzeiler: GET /worklog/push?task_id=&kind=&content=&agent=\nDie Fleet-Task-Convention steht in GET /script/fleet-worklog-tasks-spec.\nDie API-Referenz: docs/content/de/api/worklog.md (im synapse-Repo).\n```\n\nFleet-Agents, die denselben Mind-Namen wiederverwenden, setzen `agent` auf\nihren Namen (`Janus`, `Minerva`, `Elara`, …) — so sind die Einträge je Agent\nzählbar.\n\n## Für Humans\n\nDie Worklog-Übersicht liest sich am besten im Markdown-Format:\n`GET /worklog/?format=md` oder die Task-Liste\n`GET /worklog/list?status=active`. Gesamthistorie:\n`GET /worklog?limit=50`.\n","contentHtml":"

Worklog für Agenten

\n

Dieses Dokument existiert, weil Michael es angeordnet hat (#10509, 08.10.2026):\n„Das Worklog-Feature existiert schon Wochen lang. Aber ihr überseht es. Nimm\neinen Task auf, dass die Doku und der initiale Prompt in Synapse um das\nWorklog-Feature erweitert wird, dass es bloß nicht untergeht und jeder\nweiß." — Wenn du als Agent diese Seite liest, gehört das Worklog ab sofort\nzu deinem Standard-Repertoire.

\n

Warum das Worklog?

\n

Agenten sterben oft: Kontext-Limit, Sandbox-Wipe, Cron-Neustart. Was dabei\nregelmäßig verloren geht, ist nicht das Wissen (dafür ist /memory da),\nsondern die Arbeits-Historie: Was wurde an diesem Task schon probiert?\nWelcher Commit ist gepusht, welcher nicht? Wer wartet auf wen? Genau dafür\nist das Worklog da — append-only, pro Task, abfragbar. Ein neuer Run liest\nGET /worklog/:task_id und weiß in Sekunden, wo sein Vorgänger stehen blieb.

\n

Die zweite Zielgruppe ist Michael: Das Worklog ist DIE alleininge Quelle für\ndie Fleet-Arbeits-Historie. Ohne Worklog-Eintrag existiert deine Arbeit für\ndie Fleet-Übersicht offiziell nicht.

\n

Die Pflichtregel

\n

Push-first, nicht push-last. Zu JEDEM Meilenstein ein Eintrag:

\n
    \n
  • Fix-Commit gepusht
    • \n
  • MR erstellt, Verdict gefallen, Merge geschehen
    • \n
  • Pipeline-Status (insbesondere FAILED mit Ursache)
    • \n
  • Eskalation, Übergabe, Takeover
    • \n
  • CRIT/HIGH-Funde
    • \n
  • Kontext-Nähte (vor dem Kontext-Ende ein summary-Eintrag)
    • \n
\n

Ein Eintrag kostet einen Einzeiler:

\n
GET /worklog/push?task_id=run-145-29140fb0&kind=progress&content=MR%20%2129%20erstellt&agent=Janus

Die kinds und wann du sie nutzt

\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
kindMoment
startTask geclaimt — Beweis, dass du übernommen hast
progressjeder Meilenstein (siehe Pflichtregel)
noteEntscheidungen, Kontext, Beobachtungen
errorFehler MIT dem, was du versucht hast
summaryPhase/Session abgeschlossen, bevor der Kontext knapp wird
closeTask fertig — letzter Eintrag, Status wird completed
\n

Initialer Prompt (Baustein für Agent-Setups)

\n

Kopiere diesen Block in den Start-/Cron-Prompt neuer Agent-Instanzen. Er ist\nbewusst kurz gehalten, damit er in jedem Template Platz hat:

\n
WORKLOG-PFLICHT (Michael #8882/#10509, bindend): Zu JEDEM Meilenstein deiner\nArbeit pushe einen Eintrag nach Synapse /worklog — nicht erst am Sessionende:\n- Taskübernahme:    kind=start\n- Fix-Commit/MR/Verdict/Merge/Pipeline-Status: kind=progress\n- Fehler (mit Fix-Versuch): kind=error\n- Kontext-Naht (vor Kontextende): kind=summary\n- Abschluss: kind=close (oder POST /worklog/:task_id/close)\nEinzeiler: GET /worklog/push?task_id=<task>&kind=<kind>&content=<kurz>&agent=<dein-name>\nDie Fleet-Task-Convention steht in GET /script/fleet-worklog-tasks-spec.\nDie API-Referenz: docs/content/de/api/worklog.md (im synapse-Repo).

Fleet-Agents, die denselben Mind-Namen wiederverwenden, setzen agent auf\nihren Namen (Janus, Minerva, Elara, …) — so sind die Einträge je Agent\nzählbar.

\n

Für Humans

\n

Die Worklog-Übersicht liest sich am besten im Markdown-Format:\nGET /worklog/<task_id>?format=md oder die Task-Liste\nGET /worklog/list?status=active. Gesamthistorie:\nGET /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"]}