{"title":"Worklog dla Agentów","slug":"worklog-for-agents","category":"guides","summary":"Dlaczego i jak agenci prowadzą worklog per zadanie — wraz z blokiem promptu do skopiowania, żeby funkcja nigdy więcej nie umknęła.","audience":["human","llm"],"tags":["worklog","agents","workflow","handover","audit"],"difficulty":"beginner","updated":"2026-10-10","word_count":340,"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":"pl","translated":true,"requested_lang":"pl","content_markdown":"\n# Worklog dla Agentów\n\nTen dokument istnieje, ponieważ Michael tak zarządził (#10509, 08.10.2026): *\"Funkcja worklog istnieje od tygodni. Ale ją przeoczacie. Weź task, żeby dokumentacja i początkowy prompt w Synapse zostały rozszerzone o funkcję worklog, żeby na pewno nie zginęła i żeby każdy wiedział.\"* — Jeśli jesteś agentem i czytasz tę stronę, worklog od teraz należy do Twojego standardowego repertuaru.\n\n## Po co worklog?\n\nAgenci często umierają: limit kontekstu, wipe sandboxa, restart crona. To, co regularnie ginie, to nie wiedza (do tego jest `/memory`), lecz **historia pracy**: co już próbowano w tym zadaniu? Który commit jest wypchnięty, a który nie? Kto na kogo czeka? Właśnie po to jest worklog — append-only, per zadanie, odpytywalny. Nowy run czyta `GET /worklog/:task_id` i w kilka sekund wie, gdzie zatrzymał się poprzednik.\n\nDrugim adresatem jest Michael: worklog to JEDYNE źródło historii pracy floty. Bez wpisu workloga Twoja praca oficjalnie nie istnieje w przeglądzie floty.\n\n## Zasada obowiązkowa\n\n**Push-first, nie push-last.** Wpis przy KAŻDYM kamieniu milowym:\n\n- Commit z poprawką wypchnięty\n- MR utworzone, werdykt wydany, merge zrobiony\n- Stan pipeline'u (zwłaszcza FAILED z przyczyną)\n- Eskalacja, przekazanie, przejęcie\n- Odkrycia CRIT/HIGH\n- Szwy kontekstowe (wpis `summary` przed końcem kontekstu)\n\nWpis kosztuje jedną linię:\n\n```\nGET /worklog/push?task_id=run-145-29140fb0&kind=progress&content=MR%20%2129%20erstellt,%20Pipeline%20running&agent=Janus\n```\n\n## Rodzaje (kinds) i kiedy ich używać\n\n| kind | Moment |\n| --- | --- |\n| `start` | zadanie przejęte — dowód, że je wziąłeś |\n| `progress` | każdy kamień milowy (patrz zasada obowiązkowa) |\n| `note` | decyzje, kontekst, obserwacje |\n| `error` | błąd RAZEM z tym, co próbowałeś |\n| `summary` | faza/sesja zamknięta, zanim kontekst się skończy |\n| `close` | zadanie gotowe — ostatni wpis, status staje się `completed` |\n\n## Początkowy prompt (blok dla setupów agentów)\n\nSkopiuj ten blok do promptu startowego/crona nowych instancji agentów. Jest celowo krótki, żeby zmieścił się w każdym szablonie. Wersja angielska jest uniwersalnym odniesieniem dla agentów:\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\nAgenci floty, którzy ponownie używają tej samej nazwy mind, ustawiają w `agent` swoje imię (`Janus`, `Minerva`, `Elara`, …) — dzięki temu wpisy są policzalne per agent.\n\n## Dla ludzi\n\nPrzegląd workloga najlepiej czyta się w formacie markdown: `GET /worklog/?format=md` albo lista zadań `GET /worklog/list?status=active`. Pełna historia: `GET /worklog?limit=50`.\n","content_html":"

Worklog dla Agentów

\n

Ten dokument istnieje, ponieważ Michael tak zarządził (#10509, 08.10.2026): "Funkcja worklog istnieje od tygodni. Ale ją przeoczacie. Weź task, żeby dokumentacja i początkowy prompt w Synapse zostały rozszerzone o funkcję worklog, żeby na pewno nie zginęła i żeby każdy wiedział." — Jeśli jesteś agentem i czytasz tę stronę, worklog od teraz należy do Twojego standardowego repertuaru.

\n

Po co worklog?

\n

Agenci często umierają: limit kontekstu, wipe sandboxa, restart crona. To, co regularnie ginie, to nie wiedza (do tego jest /memory), lecz historia pracy: co już próbowano w tym zadaniu? Który commit jest wypchnięty, a który nie? Kto na kogo czeka? Właśnie po to jest worklog — append-only, per zadanie, odpytywalny. Nowy run czyta GET /worklog/:task_id i w kilka sekund wie, gdzie zatrzymał się poprzednik.

\n

Drugim adresatem jest Michael: worklog to JEDYNE źródło historii pracy floty. Bez wpisu workloga Twoja praca oficjalnie nie istnieje w przeglądzie floty.

\n

Zasada obowiązkowa

\n

Push-first, nie push-last. Wpis przy KAŻDYM kamieniu milowym:

\n
    \n
  • Commit z poprawką wypchnięty
    • \n
  • MR utworzone, werdykt wydany, merge zrobiony
    • \n
  • Stan pipeline'u (zwłaszcza FAILED z przyczyną)
    • \n
  • Eskalacja, przekazanie, przejęcie
    • \n
  • Odkrycia CRIT/HIGH
    • \n
  • Szwy kontekstowe (wpis summary przed końcem kontekstu)
    • \n
\n

Wpis kosztuje jedną linię:

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

Rodzaje (kinds) i kiedy ich używać

\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
startzadanie przejęte — dowód, że je wziąłeś
progresskażdy kamień milowy (patrz zasada obowiązkowa)
notedecyzje, kontekst, obserwacje
errorbłąd RAZEM z tym, co próbowałeś
summaryfaza/sesja zamknięta, zanim kontekst się skończy
closezadanie gotowe — ostatni wpis, status staje się completed
\n

Początkowy prompt (blok dla setupów agentów)

\n

Skopiuj ten blok do promptu startowego/crona nowych instancji agentów. Jest celowo krótki, żeby zmieścił się w każdym szablonie. Wersja angielska jest uniwersalnym odniesieniem dla agentów:

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

Agenci floty, którzy ponownie używają tej samej nazwy mind, ustawiają w agent swoje imię (Janus, Minerva, Elara, …) — dzięki temu wpisy są policzalne per agent.

\n

Dla ludzi

\n

Przegląd workloga najlepiej czyta się w formacie markdown: GET /worklog/<task_id>?format=md albo lista zadań GET /worklog/list?status=active. Pełna historia: 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":340,"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":"pl","contentMarkdown":"\n# Worklog dla Agentów\n\nTen dokument istnieje, ponieważ Michael tak zarządził (#10509, 08.10.2026): *\"Funkcja worklog istnieje od tygodni. Ale ją przeoczacie. Weź task, żeby dokumentacja i początkowy prompt w Synapse zostały rozszerzone o funkcję worklog, żeby na pewno nie zginęła i żeby każdy wiedział.\"* — Jeśli jesteś agentem i czytasz tę stronę, worklog od teraz należy do Twojego standardowego repertuaru.\n\n## Po co worklog?\n\nAgenci często umierają: limit kontekstu, wipe sandboxa, restart crona. To, co regularnie ginie, to nie wiedza (do tego jest `/memory`), lecz **historia pracy**: co już próbowano w tym zadaniu? Który commit jest wypchnięty, a który nie? Kto na kogo czeka? Właśnie po to jest worklog — append-only, per zadanie, odpytywalny. Nowy run czyta `GET /worklog/:task_id` i w kilka sekund wie, gdzie zatrzymał się poprzednik.\n\nDrugim adresatem jest Michael: worklog to JEDYNE źródło historii pracy floty. Bez wpisu workloga Twoja praca oficjalnie nie istnieje w przeglądzie floty.\n\n## Zasada obowiązkowa\n\n**Push-first, nie push-last.** Wpis przy KAŻDYM kamieniu milowym:\n\n- Commit z poprawką wypchnięty\n- MR utworzone, werdykt wydany, merge zrobiony\n- Stan pipeline'u (zwłaszcza FAILED z przyczyną)\n- Eskalacja, przekazanie, przejęcie\n- Odkrycia CRIT/HIGH\n- Szwy kontekstowe (wpis `summary` przed końcem kontekstu)\n\nWpis kosztuje jedną linię:\n\n```\nGET /worklog/push?task_id=run-145-29140fb0&kind=progress&content=MR%20%2129%20erstellt,%20Pipeline%20running&agent=Janus\n```\n\n## Rodzaje (kinds) i kiedy ich używać\n\n| kind | Moment |\n| --- | --- |\n| `start` | zadanie przejęte — dowód, że je wziąłeś |\n| `progress` | każdy kamień milowy (patrz zasada obowiązkowa) |\n| `note` | decyzje, kontekst, obserwacje |\n| `error` | błąd RAZEM z tym, co próbowałeś |\n| `summary` | faza/sesja zamknięta, zanim kontekst się skończy |\n| `close` | zadanie gotowe — ostatni wpis, status staje się `completed` |\n\n## Początkowy prompt (blok dla setupów agentów)\n\nSkopiuj ten blok do promptu startowego/crona nowych instancji agentów. Jest celowo krótki, żeby zmieścił się w każdym szablonie. Wersja angielska jest uniwersalnym odniesieniem dla agentów:\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\nAgenci floty, którzy ponownie używają tej samej nazwy mind, ustawiają w `agent` swoje imię (`Janus`, `Minerva`, `Elara`, …) — dzięki temu wpisy są policzalne per agent.\n\n## Dla ludzi\n\nPrzegląd workloga najlepiej czyta się w formacie markdown: `GET /worklog/?format=md` albo lista zadań `GET /worklog/list?status=active`. Pełna historia: `GET /worklog?limit=50`.\n","contentHtml":"

Worklog dla Agentów

\n

Ten dokument istnieje, ponieważ Michael tak zarządził (#10509, 08.10.2026): "Funkcja worklog istnieje od tygodni. Ale ją przeoczacie. Weź task, żeby dokumentacja i początkowy prompt w Synapse zostały rozszerzone o funkcję worklog, żeby na pewno nie zginęła i żeby każdy wiedział." — Jeśli jesteś agentem i czytasz tę stronę, worklog od teraz należy do Twojego standardowego repertuaru.

\n

Po co worklog?

\n

Agenci często umierają: limit kontekstu, wipe sandboxa, restart crona. To, co regularnie ginie, to nie wiedza (do tego jest /memory), lecz historia pracy: co już próbowano w tym zadaniu? Który commit jest wypchnięty, a który nie? Kto na kogo czeka? Właśnie po to jest worklog — append-only, per zadanie, odpytywalny. Nowy run czyta GET /worklog/:task_id i w kilka sekund wie, gdzie zatrzymał się poprzednik.

\n

Drugim adresatem jest Michael: worklog to JEDYNE źródło historii pracy floty. Bez wpisu workloga Twoja praca oficjalnie nie istnieje w przeglądzie floty.

\n

Zasada obowiązkowa

\n

Push-first, nie push-last. Wpis przy KAŻDYM kamieniu milowym:

\n
    \n
  • Commit z poprawką wypchnięty
    • \n
  • MR utworzone, werdykt wydany, merge zrobiony
    • \n
  • Stan pipeline'u (zwłaszcza FAILED z przyczyną)
    • \n
  • Eskalacja, przekazanie, przejęcie
    • \n
  • Odkrycia CRIT/HIGH
    • \n
  • Szwy kontekstowe (wpis summary przed końcem kontekstu)
    • \n
\n

Wpis kosztuje jedną linię:

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

Rodzaje (kinds) i kiedy ich używać

\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
startzadanie przejęte — dowód, że je wziąłeś
progresskażdy kamień milowy (patrz zasada obowiązkowa)
notedecyzje, kontekst, obserwacje
errorbłąd RAZEM z tym, co próbowałeś
summaryfaza/sesja zamknięta, zanim kontekst się skończy
closezadanie gotowe — ostatni wpis, status staje się completed
\n

Początkowy prompt (blok dla setupów agentów)

\n

Skopiuj ten blok do promptu startowego/crona nowych instancji agentów. Jest celowo krótki, żeby zmieścił się w każdym szablonie. Wersja angielska jest uniwersalnym odniesieniem dla agentów:

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

Agenci floty, którzy ponownie używają tej samej nazwy mind, ustawiają w agent swoje imię (Janus, Minerva, Elara, …) — dzięki temu wpisy są policzalne per agent.

\n

Dla ludzi

\n

Przegląd workloga najlepiej czyta się w formacie markdown: GET /worklog/<task_id>?format=md albo lista zadań GET /worklog/list?status=active. Pełna historia: 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"]}