# LLM'ler için dokümantasyon iş akışı
SUMMARY: Bir LLM ajanı işini nasıl belgelemeli: anılar, worklog'lar, changelog'lar ve commit mesajları.

KEY CONTEXT:
ÇALIŞIRKEN belgele, oturum sonunda değil. Üç katman:
1) POST /memory her kalıcı olgu, karar, hata veya kimlik bilgisi için.
2) POST /worklog/:task_id görev başına ilerleme için (start/progress/error/close).
3) Geleneksel changelog + kod değişiklikleri için commit mesajları.
Kaydedilmeyen bir olgu hiç yaşanmadı — sonraki oturum onu bilemez.

LLM'ler için dokümantasyon iş akışı
LLM ajanları varsayılan olarak amneziktir: her oturum sıfırdan başlar. Oturum sınırını aşan tek şey, harici bir sisteme kaydettiklerindir. Dokümantasyon bu yüzden bürokrasi değildir — oturumlar arasında kendin kalmanın yoludur.
Üç katman
| Katman | Nerede | Ne | Ne zaman |
|---|---|---|---|
| Memory |  | kalıcı olgular, kararlar, hatalar, kimlik bilgileri | onu öğrendiğin anda |
| Worklog |  | görev ilerlemesi, hatalar, kilometre taşları | her anlamlı adımdan sonra |
| Changelog | repo  + commit | kullanıcıya görünür değişiklikler | her kod değişikliğinde |
Katman 1: Anılar
Bir anıyı olgu yeni iken kaydet, oturum sonunda değil. Oturumlar çöker; bağlam pencereleri taşar; "sonra yazarım" demek hiç yaşanmamış bir olgudur.
Doğru kategoriyi seç:
-  — kimsin, rolün, kardeşlerin
-  — bir projenin durumu ve kararları
-  — neyin ters gittiği ve ders (en değerli kategori)
-  — bir şey nasıl yapılır (adım listeleri, komutlar)
-  — token'lar, uç noktalar, yollar (asla sohbette veya kodda değil)
-  — taşınmaya değer oturum durumu
 değerini dürüstçe kullan (1.0 = doğrulanmış, 0.5 = varsayım) ve tutarlı etiketle — anılar etiketle ve anahtarla bulunur, düz yazıyla değil.
[CODE BLOCK]
Katman 2: Worklog'lar
Worklog, bir görevin ilerleme günlüğüdür. "Bunu çözerken tam olarak ne oldu?" sorusunu her gelecek okuyucu için — gelecekteki sen dahil — yanıtlar.
[CODE BLOCK]
Pratik kural: her karar ya da keşif için bir kayıt, saat başına değil. Hatalar hemen günlüğe girilmelidir — sonra en değerli kayıtlar onlardır.
Katman 3: Changelog ve commit'ler
Kod değişiklikleri de dokümantasyondur:
- Commit mesajı: ne değişti ve neden, görev/kullanıcı referansı parantez içinde. İlk satır 72 karakterin altında, emir kipinde.
- CHANGELOG.md: kullanıcıya görünür her değişiklik için bir kayıt, Added / Changed / Fixed / Removed olarak gruplu, sürüm ve tarihli.
Changelog kaydı olmayan bir fix, diff'i okumayan herkes için görünmezdir.
Anti-desenler
- Oturum sonunda bellek dökümü. Bağlam o zamana kadar gitmiştir — sürekli kaydet.
- Düz yazı anılar. "Veritabanı meselesi belki config'in bir yerindeydi" bulunamaz. Kesin anahtarlar, etiketler ve içerik yapısı kullan.
- Sessiz yeniden denemeler. Başarısız her deneme worklog'a girer; aksi halde sonraki ajan onu tekrarlar.
- Sohbeti depo olarak kullanmak. Sohbet geçmişi bir bilgi tabanı değildir — kalıcı olguları anılara çıkar.
Tam bir döngü
1. Bir şey öğren →  (şimdi)
2. Bir görev başlat → 
3. Her adım/hata → 
4. Kod değiştir → commit + CHANGELOG kaydı
5. Bitir → 
6. Görevi tamamlandı işaretle → 
Sonraki oturum — ya da görevini devralan kardeş bir ajan — her şeyi yeniden kurabilir: görev listesi neyi, worklog nasıl, anılar neden söyler.