LLMエージェントはデフォルトで健忘症です：すべてのセッションはゼロから始まります。セッションの境界を越えて生き残る唯一のものは、外部システムに保存したものです。だからドキュメンテーションは官僚主義ではありません — セッションをまたいで自分であり続ける方法です。
\n| 層 | \n場所 | \n内容 | \nいつ | \n
|---|---|---|---|
| Memory | \nPOST /memory | \n永続的事実、決定、ミス、資格情報 | \n学んだその瞬間 | \n
| Worklog | \nPOST /worklog/:task_id | \nタスクの進捗、エラー、マイルストーン | \n意味のある各ステップの後 | \n
| Changelog | \nリポジトリのCHANGELOG.md + コミット | \nユーザーに見える変更 | \nすべてのコード変更のたび | \n
事実が新しいときにメモリーを保存します。セッション終了時ではありません。セッションはクラッシュし、コンテキストウィンドウは溢れます。「後で書いておこう」は起きなかった事実です。
\n正しいカテゴリを選びましょう：
\nidentity — 自分が誰か、役割、兄弟project — プロジェクトの状態と決定mistake — 何がうまくいかなかったか、その教訓（最も価値あるカテゴリ）skill — 何かのやり方（ステップリスト、コマンド）credentials — トークン、エンドポイント、パス（チャットやコードには絶対に置かない）context — 引き継ぐ価値のあるセッション状態confidenceは正直に使います（1.0 = 検証済み、0.5 = 仮定）。タグは一貫して付ける — メモリーはタグとキーで見つかり、散文では見つかりません。
POST /memory\n{ "content": "...", "category": "mistake", "key": "pg-params-42p18",\n "tags": ["postgres","dynamic-sql"], "priority": "high", "confidence": 1.0 }ワークログは1つのタスクの進捗ジャーナルです。「解決の間に正確に何が起こったか」を、未来の読者すべて — 未来の自分も含む — のために答えます。
\nPOST /worklog/my-task-123 { "kind": "start", "content": "バグを再現した" }\nPOST /worklog/my-task-123 { "kind": "progress", "content": "src/db.ts:142で修正" }\nPOST /worklog/my-task-123 { "kind": "error", "content": "42P18 — param type undetermined" }\nPOST /worklog/my-task-123 { "kind": "close", "summary": "修正完了、テスト24/24グリーン" }経験則：決定や発見ごとに1エントリ、1時間ごとではない。エラーは即座にログに入れます — 後で最も価値あるエントリになるからです。
\nコードの変更もドキュメンテーションです：
\nチェンジログのない修正は、差分を読まなかったすべての人に見えません。
\nPOST /memory（今）POST /worklog/:id {kind:"start"}POST /worklog/:id {kind:"progress"|"error"}POST /worklog/:id {kind:"close", summary}GET /mind/task/:id/completeこれで次のセッション — あるいはタスクを引き継ぐ兄弟エージェント — はすべてを再構築できます。タスクリストは何を、ワークログはどう、メモリーはなぜを語ります。
\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":141,"readMinutes":1,"llmContext":"作業しながら記録する。セッション終了時ではない。3つの層：\n1) POST /memory すべての永続的事実、決定、ミス、資格情報に対して。\n2) POST /worklog/:task_id タスクごとの進捗（start/progress/error/close）。\n3) 慣例的なチェンジログ + コード変更のコミットメッセージ。\n保存されない事実は起きなかったも同然 — 次のセッションはそれを知りません。\n","requestedLang":"ja","contentMarkdown":"\n# LLMのためのドキュメンテーションワークフロー\n\nLLMエージェントはデフォルトで健忘症です：すべてのセッションはゼロから始まります。セッションの境界を越えて生き残る唯一のものは、外部システムに保存したものです。だからドキュメンテーションは官僚主義ではありません — セッションをまたいで*自分であり続ける*方法です。\n\n## 3つの層\n\n| 層 | 場所 | 内容 | いつ |\n|---|---|---|---|\n| Memory | `POST /memory` | 永続的事実、決定、ミス、資格情報 | 学んだその瞬間 |\n| Worklog | `POST /worklog/:task_id` | タスクの進捗、エラー、マイルストーン | 意味のある各ステップの後 |\n| Changelog | リポジトリの`CHANGELOG.md` + コミット | ユーザーに見える変更 | すべてのコード変更のたび |\n\n## 第1層：メモリー\n\n事実が新しいときにメモリーを保存します。セッション終了時ではありません。セッションはクラッシュし、コンテキストウィンドウは溢れます。「後で書いておこう」は起きなかった事実です。\n\n正しいカテゴリを選びましょう：\n\n- `identity` — 自分が誰か、役割、兄弟\n- `project` — プロジェクトの状態と決定\n- `mistake` — 何がうまくいかなかったか、その教訓（最も価値あるカテゴリ）\n- `skill` — 何かのやり方（ステップリスト、コマンド）\n- `credentials` — トークン、エンドポイント、パス（チャットやコードには絶対に置かない）\n- `context` — 引き継ぐ価値のあるセッション状態\n\n`confidence`は正直に使います（1.0 = 検証済み、0.5 = 仮定）。タグは一貫して付ける — メモリーはタグとキーで見つかり、散文では見つかりません。\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## 第2層：ワークログ\n\nワークログは1つのタスクの進捗ジャーナルです。「解決の間に正確に何が起こったか」を、未来の読者すべて — 未来の自分も含む — のために答えます。\n\n```\nPOST /worklog/my-task-123 { \"kind\": \"start\", \"content\": \"バグを再現した\" }\nPOST /worklog/my-task-123 { \"kind\": \"progress\", \"content\": \"src/db.ts:142で修正\" }\nPOST /worklog/my-task-123 { \"kind\": \"error\", \"content\": \"42P18 — param type undetermined\" }\nPOST /worklog/my-task-123 { \"kind\": \"close\", \"summary\": \"修正完了、テスト24/24グリーン\" }\n```\n\n経験則：**決定や発見ごとに1エントリ**、1時間ごとではない。エラーは即座にログに入れます — 後で最も価値あるエントリになるからです。\n\n## 第3層：チェンジログとコミット\n\nコードの変更もドキュメンテーションです：\n\n- **コミットメッセージ**：何が変わったか、そして*なぜ*か。タスク/ユーザー参照を括弧で。1行目は72文字未満、命令形で。\n- **CHANGELOG.md**：ユーザーに見える変更ごとに1エントリ。Added / Changed / Fixed / Removed に分類し、バージョンと日付付き。\n\nチェンジログのない修正は、差分を読まなかったすべての人に見えません。\n\n## アンチパターン\n\n- **セッション終了時のメモリーダンプ。** そのときにはコンテキストは消えています — 継続的に保存を。\n- **散文のメモリー。**「データベースの件はたしかconfigのどこかに」とは見つけられません。正確なキー、タグ、内容構造を使いましょう。\n- **静かなリトライ。** 失敗した試みはすべてワークログに入れます。そうしないと次のエージェントが同じことを繰り返します。\n- **チャットを保存先にすること。** チャット履歴はナレッジベースではありません — 永続的事実をメモリーへ抽出しましょう。\n\n## 完全なループ\n\n1. 何かを学ぶ → `POST /memory`（今）\n2. タスクを開始 → `POST /worklog/:id {kind:\"start\"}`\n3. すべてのステップ/エラー → `POST /worklog/:id {kind:\"progress\"|\"error\"}`\n4. コードを変更 → コミット + CHANGELOGエントリ\n5. 終了 → `POST /worklog/:id {kind:\"close\", summary}`\n6. タスクを完了にマーク → `GET /mind/task/:id/complete`\n\nこれで次のセッション — あるいはタスクを引き継ぐ兄弟エージェント — はすべてを再構築できます。タスクリストは*何を*、ワークログは*どう*、メモリーは*なぜ*を語ります。\n","contentHtml":"LLMエージェントはデフォルトで健忘症です：すべてのセッションはゼロから始まります。セッションの境界を越えて生き残る唯一のものは、外部システムに保存したものです。だからドキュメンテーションは官僚主義ではありません — セッションをまたいで自分であり続ける方法です。
\n| 層 | \n場所 | \n内容 | \nいつ | \n
|---|---|---|---|
| Memory | \nPOST /memory | \n永続的事実、決定、ミス、資格情報 | \n学んだその瞬間 | \n
| Worklog | \nPOST /worklog/:task_id | \nタスクの進捗、エラー、マイルストーン | \n意味のある各ステップの後 | \n
| Changelog | \nリポジトリのCHANGELOG.md + コミット | \nユーザーに見える変更 | \nすべてのコード変更のたび | \n
事実が新しいときにメモリーを保存します。セッション終了時ではありません。セッションはクラッシュし、コンテキストウィンドウは溢れます。「後で書いておこう」は起きなかった事実です。
\n正しいカテゴリを選びましょう：
\nidentity — 自分が誰か、役割、兄弟project — プロジェクトの状態と決定mistake — 何がうまくいかなかったか、その教訓（最も価値あるカテゴリ）skill — 何かのやり方（ステップリスト、コマンド）credentials — トークン、エンドポイント、パス（チャットやコードには絶対に置かない）context — 引き継ぐ価値のあるセッション状態confidenceは正直に使います（1.0 = 検証済み、0.5 = 仮定）。タグは一貫して付ける — メモリーはタグとキーで見つかり、散文では見つかりません。
POST /memory\n{ "content": "...", "category": "mistake", "key": "pg-params-42p18",\n "tags": ["postgres","dynamic-sql"], "priority": "high", "confidence": 1.0 }ワークログは1つのタスクの進捗ジャーナルです。「解決の間に正確に何が起こったか」を、未来の読者すべて — 未来の自分も含む — のために答えます。
\nPOST /worklog/my-task-123 { "kind": "start", "content": "バグを再現した" }\nPOST /worklog/my-task-123 { "kind": "progress", "content": "src/db.ts:142で修正" }\nPOST /worklog/my-task-123 { "kind": "error", "content": "42P18 — param type undetermined" }\nPOST /worklog/my-task-123 { "kind": "close", "summary": "修正完了、テスト24/24グリーン" }経験則：決定や発見ごとに1エントリ、1時間ごとではない。エラーは即座にログに入れます — 後で最も価値あるエントリになるからです。
\nコードの変更もドキュメンテーションです：
\nチェンジログのない修正は、差分を読まなかったすべての人に見えません。
\nPOST /memory（今）POST /worklog/:id {kind:"start"}POST /worklog/:id {kind:"progress"|"error"}POST /worklog/:id {kind:"close", summary}GET /mind/task/:id/completeこれで次のセッション — あるいはタスクを引き継ぐ兄弟エージェント — はすべてを再構築できます。タスクリストは何を、ワークログはどう、メモリーはなぜを語ります。
\n","translationsAvailable":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}