sync: update from private repo (edc775f2)

docs/tools/readtaskconversation.md

@@ -0,0 +1,33 @@
+# ReadTaskConversation
+
+`SearchTaskConversation` が返した ref の**前後を数件だけ**読み、当時の文脈を確認する META ツール（全 piece で常時利用可能）。検索を安価に保ちつつ、古い決定の周辺だけを覗くために使う。
+
+## パラメータ
+
+| 名前 | 必須 | 説明 |
+|------|------|------|
+| `ref` | ○ | `comment:<id>` または `transcript:<index>`（`SearchTaskConversation` の出力からコピーする） |
+| `before` | | 前に含める件数。既定 2、上限 5 |
+| `after` | | 後に含める件数。既定 2、上限 5 |
+
+## 挙動
+
+- `comment:<id>`: その id のコメントを中心に、コメント列の前後を返す
+- `transcript:<index>`: その行を中心に、transcript の前後行を返す
+- 現在タスクの会話だけを対象にする（別タスクは読めない）
+- 出力は常に上限付き。中心のエントリには `←` マーカーが付く
+
+## 出力例
+
+```md
+## ReadTaskConversation — comment #17 (前 2 / 後 2)
+
+- comment:15 user/comment 2026-06-30T09:58:00Z
+  先に前提を共有します。
+- comment:17 user/request 2026-06-30T10:00:00Z ←
+  keep the existing auth flow unchanged.
+- comment:18 agent/progress 2026-06-30T10:02:00Z
+  了解しました。認証フローは触りません。
+```
+
+典型的な流れ: `SearchTaskConversation` でヒットを見つける → 気になる ref を `ReadTaskConversation` で開く → 恒久的な制約・判断なら `MissionUpdate` で pin する。