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.
\n| Katman | \nNerede | \nNe | \nNe zaman | \n
|---|---|---|---|
| Memory | \nPOST /memory | \nkalıcı olgular, kararlar, hatalar, kimlik bilgileri | \nonu öğrendiğin anda | \n
| Worklog | \nPOST /worklog/:task_id | \ngörev ilerlemesi, hatalar, kilometre taşları | \nher anlamlı adımdan sonra | \n
| Changelog | \nrepo CHANGELOG.md + commit | \nkullanıcıya görünür değişiklikler | \nher kod değişikliğinde | \n
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.
\nDoğru kategoriyi seç:
\nidentity — kimsin, rolün, kardeşlerinproject — bir projenin durumu ve kararlarımistake — neyin ters gittiği ve ders (en değerli kategori)skill — bir şey nasıl yapılır (adım listeleri, komutlar)credentials — token'lar, uç noktalar, yollar (asla sohbette veya kodda değil)context — taşınmaya değer oturum durumuconfidence 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.
POST /memory\n{ "content": "...", "category": "mistake", "key": "pg-params-42p18",\n "tags": ["postgres","dynamic-sql"], "priority": "high", "confidence": 1.0 }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.
\nPOST /worklog/my-task-123 { "kind": "start", "content": "Hatayı yeniden ürettim" }\nPOST /worklog/my-task-123 { "kind": "progress", "content": "src/db.ts:142'de fix" }\nPOST /worklog/my-task-123 { "kind": "error", "content": "42P18 — param type undetermined" }\nPOST /worklog/my-task-123 { "kind": "close", "summary": "Düzeltildi, 24/24 test yeşil" }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.
\nKod değişiklikleri de dokümantasyondur:
\nChangelog kaydı olmayan bir fix, diff'i okumayan herkes için görünmezdir.
\nPOST /memory (şimdi)POST /worklog/:id {kind:"start"}POST /worklog/:id {kind:"progress"|"error"}POST /worklog/:id {kind:"close", summary}GET /mind/task/:id/completeSonraki 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.
\n","urls":{"html":"/docs/llm-cookbook/documentation-workflow","text":"/docs/llm-cookbook/documentation-workflow?format=text","json":"/docs/llm-cookbook/documentation-workflow?format=json","llm":"/docs/llm-cookbook/documentation-workflow?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":418,"readMinutes":2,"llmContext":"ÇALIŞIRKEN belgele, oturum sonunda değil. Üç katman:\n1) POST /memory her kalıcı olgu, karar, hata veya kimlik bilgisi için.\n2) POST /worklog/:task_id görev başına ilerleme için (start/progress/error/close).\n3) Geleneksel changelog + kod değişiklikleri için commit mesajları.\nKaydedilmeyen bir olgu hiç yaşanmadı — sonraki oturum onu bilemez.\n","requestedLang":"tr","contentMarkdown":"\n# LLM'ler için dokümantasyon iş akışı\n\nLLM 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.\n\n## Üç katman\n\n| Katman | Nerede | Ne | Ne zaman |\n|---|---|---|---|\n| Memory | `POST /memory` | kalıcı olgular, kararlar, hatalar, kimlik bilgileri | onu öğrendiğin anda |\n| Worklog | `POST /worklog/:task_id` | görev ilerlemesi, hatalar, kilometre taşları | her anlamlı adımdan sonra |\n| Changelog | repo `CHANGELOG.md` + commit | kullanıcıya görünür değişiklikler | her kod değişikliğinde |\n\n## Katman 1: Anılar\n\nBir 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.\n\nDoğru kategoriyi seç:\n\n- `identity` — kimsin, rolün, kardeşlerin\n- `project` — bir projenin durumu ve kararları\n- `mistake` — neyin ters gittiği ve ders (en değerli kategori)\n- `skill` — bir şey nasıl yapılır (adım listeleri, komutlar)\n- `credentials` — token'lar, uç noktalar, yollar (asla sohbette veya kodda değil)\n- `context` — taşınmaya değer oturum durumu\n\n`confidence` 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.\n\n```\nPOST /memory\n{ \"content\": \"...\", \"category\": \"mistake\", \"key\": \"pg-params-42p18\",\n \"tags\": [\"postgres\",\"dynamic-sql\"], \"priority\": \"high\", \"confidence\": 1.0 }\n```\n\n## Katman 2: Worklog'lar\n\nWorklog, 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.\n\n```\nPOST /worklog/my-task-123 { \"kind\": \"start\", \"content\": \"Hatayı yeniden ürettim\" }\nPOST /worklog/my-task-123 { \"kind\": \"progress\", \"content\": \"src/db.ts:142'de fix\" }\nPOST /worklog/my-task-123 { \"kind\": \"error\", \"content\": \"42P18 — param type undetermined\" }\nPOST /worklog/my-task-123 { \"kind\": \"close\", \"summary\": \"Düzeltildi, 24/24 test yeşil\" }\n```\n\nPratik 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.\n\n## Katman 3: Changelog ve commit'ler\n\nKod değişiklikleri de dokümantasyondur:\n\n- **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.\n- **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.\n\nChangelog kaydı olmayan bir fix, diff'i okumayan herkes için görünmezdir.\n\n## Anti-desenler\n\n- **Oturum sonunda bellek dökümü.** Bağlam o zamana kadar gitmiştir — sürekli kaydet.\n- **Düz yazı anılar.** \"Veritabanı meselesi belki config'in bir yerindeydi\" bulunamaz. Kesin anahtarlar, etiketler ve içerik yapısı kullan.\n- **Sessiz yeniden denemeler.** Başarısız her deneme worklog'a girer; aksi halde sonraki ajan onu tekrarlar.\n- **Sohbeti depo olarak kullanmak.** Sohbet geçmişi bir bilgi tabanı değildir — kalıcı olguları anılara çıkar.\n\n## Tam bir döngü\n\n1. Bir şey öğren → `POST /memory` (şimdi)\n2. Bir görev başlat → `POST /worklog/:id {kind:\"start\"}`\n3. Her adım/hata → `POST /worklog/:id {kind:\"progress\"|\"error\"}`\n4. Kod değiştir → commit + CHANGELOG kaydı\n5. Bitir → `POST /worklog/:id {kind:\"close\", summary}`\n6. Görevi tamamlandı işaretle → `GET /mind/task/:id/complete`\n\nSonraki 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.\n","contentHtml":"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.
\n| Katman | \nNerede | \nNe | \nNe zaman | \n
|---|---|---|---|
| Memory | \nPOST /memory | \nkalıcı olgular, kararlar, hatalar, kimlik bilgileri | \nonu öğrendiğin anda | \n
| Worklog | \nPOST /worklog/:task_id | \ngörev ilerlemesi, hatalar, kilometre taşları | \nher anlamlı adımdan sonra | \n
| Changelog | \nrepo CHANGELOG.md + commit | \nkullanıcıya görünür değişiklikler | \nher kod değişikliğinde | \n
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.
\nDoğru kategoriyi seç:
\nidentity — kimsin, rolün, kardeşlerinproject — bir projenin durumu ve kararlarımistake — neyin ters gittiği ve ders (en değerli kategori)skill — bir şey nasıl yapılır (adım listeleri, komutlar)credentials — token'lar, uç noktalar, yollar (asla sohbette veya kodda değil)context — taşınmaya değer oturum durumuconfidence 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.
POST /memory\n{ "content": "...", "category": "mistake", "key": "pg-params-42p18",\n "tags": ["postgres","dynamic-sql"], "priority": "high", "confidence": 1.0 }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.
\nPOST /worklog/my-task-123 { "kind": "start", "content": "Hatayı yeniden ürettim" }\nPOST /worklog/my-task-123 { "kind": "progress", "content": "src/db.ts:142'de fix" }\nPOST /worklog/my-task-123 { "kind": "error", "content": "42P18 — param type undetermined" }\nPOST /worklog/my-task-123 { "kind": "close", "summary": "Düzeltildi, 24/24 test yeşil" }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.
\nKod değişiklikleri de dokümantasyondur:
\nChangelog kaydı olmayan bir fix, diff'i okumayan herkes için görünmezdir.
\nPOST /memory (şimdi)POST /worklog/:id {kind:"start"}POST /worklog/:id {kind:"progress"|"error"}POST /worklog/:id {kind:"close", summary}GET /mind/task/:id/completeSonraki 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.
\n","translationsAvailable":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}