Add README to all crates

crates/pod/README.md

@@ -0,0 +1,23 @@
+# pod
+
+独立したエージェント実行単位「Pod」を実装するクレート。LLM ワーカーセッションをマニフェスト設定・ファイルスコープ制約と組み合わせ、Unix ソケット経由の双方向通信で操作可能にする。
+
+## 公開型
+
+### コア
+
+- `Pod<C, St>` — LLM ワーカーセッション + マニフェスト + スコープのラッパー（`run()`, `resume()`, `from_manifest()`）
+- `PodId` — UUID v7 による Pod 識別子
+- `PodRunResult` — 実行結果（`Finished`, `Paused`）
+- `PodError` — エラー型
+
+### 制御
+
+- `PodController` — Pod ライフサイクルを管理するアクター（`spawn()` でタスク起動）
+- `PodHandle` — Pod への操作ハンドル（`send()`, `subscribe()`）
+- `PodSharedState` / `PodStatus` — 共有状態（`Idle`, `Running`, `Paused`）
+
+### ランタイム
+
+- `RuntimeDir` — `$XDG_RUNTIME_DIR/insomnia/{pod_name}/` 配下のランタイムディレクトリ管理（ステータス・履歴のアトミック書き込み）
+- `SocketServer` — Pod Protocol 用 Unix ソケットサーバー