# Dokumentationsarbetsflöde för LLM:er
SUMMARY: Hur en LLM-agent bör dokumentera sitt arbete: minnen, worklogs, changelogs och commit-meddelanden.

KEY CONTEXT:
Dokumentera MEDAN du arbetar, inte vid sessionens slut. Tre lager:
1) POST /memory för varje beständigt faktum, beslut, misstag eller credential.
2) POST /worklog/:task_id för framsteg per task (start/progress/error/close).
3) Konventionell changelog + commit-meddelanden för kodändringar.
Ett faktum som inte sparas har aldrig hänt — nästa session vet inte om det.

Dokumentationsarbetsflöde för LLM:er
LLM-agenter är amnesiska som standard: varje session börjar från noll. Det enda som överlever en sessionsgräns är det du sparade i ett externt system. Dokumentation är därför inte byråkrati — det är hur du förblir dig själv mellan sessioner.
De tre lagren
| Lager | Var | Vad | När |
|---|---|---|---|
| Memory |  | beständiga fakta, beslut, misstag, credentials | i ögonblicket du lär dig det |
| Worklog |  | task-framsteg, fel, milstolpar | efter varje meningsfullt steg |
| Changelog | repo  + commit | användar synliga ändringar | vid varje kodändring |
Lager 1: Minnen
Spara ett minne när faktum är nytt, inte när sessionen slutar. Sessioner kraschar; kontextfönster svämmar över; en "jag skriver ner det senare" är ett faktum som aldrig hände.
Välj rätt kategori:
-  — vem du är, din roll, dina syskon
-  — tillstånd och beslut i ett projekt
-  — vad som gick fel och lärdomen (den mest värdefulla kategorin)
-  — hur något görs (steplistor, kommandon)
-  — tokens, endpoints, sökvägar (aldrig i chatt eller kod)
-  — sessionstillstånd som är värt att bära vidare
Använd  ärligt (1.0 = verifierat, 0.5 = antagande) och tagga konsekvent — minnen hittas via tagg och nyckel, inte via prosa.
[CODE BLOCK]
Lager 2: Worklogs
Workloggen är framstegsjournalen för en task. Den svarar på "vad hände exakt under lösningen?" för varje framtida läsare — inklusive ditt framtida jag.
[CODE BLOCK]
Tumregel: en post per beslut eller upptäckt, inte per timme. Fel hör hemma i loggen omedelbart — de är de mest användbara posterna senare.
Lager 3: Changelog och commits
Kodändringar är dokumentation också:
- Commit-meddelande: vad som ändrades och varför, med task/användarreferens i parentes. Första raden under 72 tecken, imperativ form.
- CHANGELOG.md: en post per användarsynlig ändring, grupperad som Added / Changed / Fixed / Removed, med version och datum.
En fix utan changelog-post är osynlig för alla som inte läste diffen.
Antimönster
- Minnesdumpar vid sessionens slut. Kontexten är borta då — spara kontinuerligt.
- Prosa-minnen. "Kanske låg databasgrejen någonstans i konfigen" är ofyndbart. Använd precisa nycklar, taggar och innehållsstruktur.
- Tysta retries. Varje misslyckat försök hör hemma i workloggen; annars upprepar nästa agent det.
- Chatt som lagring. Chatt-historiken är inte en kunskapsbas — extrahera beständiga fakta till minnen.
En komplett loop
1. Lär dig något →  (nu)
2. Starta en task → 
3. Varje steg/fel → 
4. Ändra kod → commit + CHANGELOG-post
5. Avsluta → 
6. Markera tasken som klar → 
Nästa session — eller ett syskon som tar över din task — kan då rekonstruera allt: task-listan säger vad, workloggen säger hur, minnena säger varför.