diff --git a/work-items/open/20260527-000011-session-todo-reminder/artifacts/.gitkeep b/work-items/closed/20260527-000011-session-todo-reminder/artifacts/.gitkeep similarity index 100% rename from work-items/open/20260527-000011-session-todo-reminder/artifacts/.gitkeep rename to work-items/closed/20260527-000011-session-todo-reminder/artifacts/.gitkeep diff --git a/work-items/open/20260527-000011-session-todo-reminder/item.md b/work-items/closed/20260527-000011-session-todo-reminder/item.md similarity index 99% rename from work-items/open/20260527-000011-session-todo-reminder/item.md rename to work-items/closed/20260527-000011-session-todo-reminder/item.md index 2d1bf378..ac476fe9 100644 --- a/work-items/open/20260527-000011-session-todo-reminder/item.md +++ b/work-items/closed/20260527-000011-session-todo-reminder/item.md @@ -2,12 +2,12 @@ id: 20260527-000011-session-todo-reminder slug: session-todo-reminder title: セッション内 Task ツールの注意機構 -status: open +status: closed kind: task priority: P2 labels: [migrated] created_at: 2026-05-27T00:00:11Z -updated_at: 2026-05-27T00:00:11Z +updated_at: 2026-05-29T04:31:10Z assignee: null legacy_ticket: tickets/session-todo-reminder.md --- diff --git a/work-items/closed/20260527-000011-session-todo-reminder/resolution.md b/work-items/closed/20260527-000011-session-todo-reminder/resolution.md new file mode 100644 index 00000000..ac476fe9 --- /dev/null +++ b/work-items/closed/20260527-000011-session-todo-reminder/resolution.md @@ -0,0 +1,80 @@ +--- +id: 20260527-000011-session-todo-reminder +slug: session-todo-reminder +title: セッション内 Task ツールの注意機構 +status: closed +kind: task +priority: P2 +labels: [migrated] +created_at: 2026-05-27T00:00:11Z +updated_at: 2026-05-29T04:31:10Z +assignee: null +legacy_ticket: tickets/session-todo-reminder.md +--- + +## Migration reference + +- legacy_ticket: tickets/session-todo-reminder.md +- migrated_from: TODO.md / tickets directory migration on 2026-05-27 + +# セッション内 Task ツールの注意機構 + +## 背景 + +`tickets/session-todo.md` で導入した Task ツール群があっても、LLM はそれを使わずに作業を続け得る。ツールを呼ばないまま会話が長引くと、 + +- 開始した作業の `inprogress` がずっと放置されたままになる +- 「やったつもり」になって `completed` への更新を忘れる +- そもそも TaskStore の存在を忘れて、構造化を諦めて自由記述に回帰する + +OpenCode の todo は専用の注意機構を持たない（汎用 reminder 経由）。一方、一部の既存エージェント実装では todo reminder を「N リクエスト無アクティビティで初めて発火するナッジ型」として扱い、毎リクエスト押し戻しはしない。 + + +Insomnia でも同方針を採り、active Task が残っているのに `TaskCreate` / `TaskUpdate` が一定リクエスト呼ばれていない場合に限り、`` Item を 1件 history に append する。「やったつもり」抑止と、トークン浪費・LLM の自律性侵害のバランスを取るため、毎リクエスト押し戻しはしない。 + +## 前提 + +- `tickets/session-todo.md` の TaskStore と `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` ツールが利用可能 +- `Interceptor::pending_history_appends` レーンが利用可能（`tickets/notify-history-persist.md` で導入済み） + +## 方針 + +- **`pending_history_appends` で実装**。発火時に `` ブロックを含む新規 system message Item を返し、Worker が `worker.history` に append する。Notify / PodEvent と同じレーンで永続化・resume・compaction が自動で揃う +- **揮発的注入は採らない**（`AGENTS.md` 「LLM コンテキストの加工原則」で禁止。history に commit せずに context を変えると、resume 時に LLM の発言の根拠が再現できなくなる） +- **system-reminder 注入機構の汎用化はやらない**。利用者が Task 1機構しかない段階で抽象を立てない（`AGENTS.md`「概念の追加は不在が問題になってから」）。タグ形式 `...` の規約は本実装で踏襲する +- **発火はナッジ型**。N リクエスト無アクティビティで初めて発火し、cooldown も持つ + +## 要件 + +### Interceptor + +- `pending_history_appends` で以下を **AND** で満たす場合のみ発動し、`` ブロックを含む `Item::system_message` を 1件返す。条件外なら空 `Vec` を返す + - active Task（`pending` または `inprogress`）が 1件以上存在する + - 直近 N リクエスト（暫定 N=8）`TaskCreate` / `TaskUpdate` のいずれも呼ばれていない + - 前回 reminder Item の append から M リクエスト（暫定 M=8）以上経過 +- ここで言う「リクエスト」は LLM への 1回の推論呼び出し（assistant 応答 1回）の単位。1ユーザー発火内で tool ループが回れば、`tool_result` を受けて発火する次のリクエストもそれぞれ 1としてカウントする +- カウンタは Pod 側の session-lifetime 状態として保持する（`requests_since_last_task_management` / `requests_since_last_reminder`）。resume 時は worker.history の逆走査で再計算するか 0 リセットで再開する。後者でも「初回ナッジが最大 N リクエスト遅れる」だけで挙動として致命ではない +- 返す Item の本文は `` で囲み、現在の active Task を `taskid` / `status` / `subject` を含む簡潔な形式で列挙する。`description` は長大化を避けるため省略してよい +- active Task が空の場合は何も append しない（思い出させる対象が無いなら不要） + +## 完了条件 + +- 直近 N リクエスト連続で `TaskCreate` / `TaskUpdate` が呼ばれず、かつ active Task が残っている場合に限り、`pending_history_appends` が `` を含む `Item::system_message` を 1件返す +- 返された Item が `worker.history` に append され、その後のリクエスト・`history.json`・resume 後の `get_history` でも同じ Item が見える（揮発レーンは持たない） +- `TaskCreate` / `TaskUpdate` のいずれかが呼ばれるとカウンタがリセットされ、再び N リクエスト経過するまでは reminder が出ない +- reminder が一度出たあとは、cooldown M リクエストが経過するまで再注入されない +- active Task が 0件の場合は reminder が出ない +- 単体テストで Interceptor の発火条件（リクエスト回数閾値、active 0件、cooldown）がカバーされる + +## 範囲外 + +- inprogress 滞留検出 / 多重 inprogress 検出など、状態異常ベースの追加トリガ（必要になれば別チケットで追加） +- system-reminder 注入機構の汎用化（`TODO.md` に立項済み、別途検討） +- `TaskCreate` / `TaskUpdate` の戻り値に active Task 全件を埋め込む強化（必要に応じて Tool ticket 側で対応） +- サブエージェント / sidechain での独自 reminder 発火（main Pod の interceptor から動く構造のため自然に対象外） + +## 参照 + +- 設計指針: `AGENTS.md`（LLM コンテキストの加工原則。揮発的注入は禁止、history に append してから commit する） +- 前提: `tickets/session-todo.md`（Tool 群と TaskStore）、`tickets/notify-history-persist.md`（`pending_history_appends` レーン） +- 参考: 一部エージェント実装の todo reminder は、一定リクエスト無アクティビティ後に発火し、再通知にも cooldown を置くナッジ型として扱われている diff --git a/work-items/closed/20260527-000011-session-todo-reminder/thread.md b/work-items/closed/20260527-000011-session-todo-reminder/thread.md new file mode 100644 index 00000000..f7542beb --- /dev/null +++ b/work-items/closed/20260527-000011-session-todo-reminder/thread.md @@ -0,0 +1,95 @@ + + +## Migrated + +Migrated from tickets/session-todo-reminder.md. No legacy review file was present at migration time. + +--- + + + +## Closed + +--- +id: 20260527-000011-session-todo-reminder +slug: session-todo-reminder +title: セッション内 Task ツールの注意機構 +status: closed +kind: task +priority: P2 +labels: [migrated] +created_at: 2026-05-27T00:00:11Z +updated_at: 2026-05-29T04:31:10Z +assignee: null +legacy_ticket: tickets/session-todo-reminder.md +--- + +## Migration reference + +- legacy_ticket: tickets/session-todo-reminder.md +- migrated_from: TODO.md / tickets directory migration on 2026-05-27 + +# セッション内 Task ツールの注意機構 + +## 背景 + +`tickets/session-todo.md` で導入した Task ツール群があっても、LLM はそれを使わずに作業を続け得る。ツールを呼ばないまま会話が長引くと、 + +- 開始した作業の `inprogress` がずっと放置されたままになる +- 「やったつもり」になって `completed` への更新を忘れる +- そもそも TaskStore の存在を忘れて、構造化を諦めて自由記述に回帰する + +OpenCode の todo は専用の注意機構を持たない（汎用 reminder 経由）。一方、一部の既存エージェント実装では todo reminder を「N リクエスト無アクティビティで初めて発火するナッジ型」として扱い、毎リクエスト押し戻しはしない。 + + +Insomnia でも同方針を採り、active Task が残っているのに `TaskCreate` / `TaskUpdate` が一定リクエスト呼ばれていない場合に限り、`` Item を 1件 history に append する。「やったつもり」抑止と、トークン浪費・LLM の自律性侵害のバランスを取るため、毎リクエスト押し戻しはしない。 + +## 前提 + +- `tickets/session-todo.md` の TaskStore と `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` ツールが利用可能 +- `Interceptor::pending_history_appends` レーンが利用可能（`tickets/notify-history-persist.md` で導入済み） + +## 方針 + +- **`pending_history_appends` で実装**。発火時に `` ブロックを含む新規 system message Item を返し、Worker が `worker.history` に append する。Notify / PodEvent と同じレーンで永続化・resume・compaction が自動で揃う +- **揮発的注入は採らない**（`AGENTS.md` 「LLM コンテキストの加工原則」で禁止。history に commit せずに context を変えると、resume 時に LLM の発言の根拠が再現できなくなる） +- **system-reminder 注入機構の汎用化はやらない**。利用者が Task 1機構しかない段階で抽象を立てない（`AGENTS.md`「概念の追加は不在が問題になってから」）。タグ形式 `...` の規約は本実装で踏襲する +- **発火はナッジ型**。N リクエスト無アクティビティで初めて発火し、cooldown も持つ + +## 要件 + +### Interceptor + +- `pending_history_appends` で以下を **AND** で満たす場合のみ発動し、`` ブロックを含む `Item::system_message` を 1件返す。条件外なら空 `Vec` を返す + - active Task（`pending` または `inprogress`）が 1件以上存在する + - 直近 N リクエスト（暫定 N=8）`TaskCreate` / `TaskUpdate` のいずれも呼ばれていない + - 前回 reminder Item の append から M リクエスト（暫定 M=8）以上経過 +- ここで言う「リクエスト」は LLM への 1回の推論呼び出し（assistant 応答 1回）の単位。1ユーザー発火内で tool ループが回れば、`tool_result` を受けて発火する次のリクエストもそれぞれ 1としてカウントする +- カウンタは Pod 側の session-lifetime 状態として保持する（`requests_since_last_task_management` / `requests_since_last_reminder`）。resume 時は worker.history の逆走査で再計算するか 0 リセットで再開する。後者でも「初回ナッジが最大 N リクエスト遅れる」だけで挙動として致命ではない +- 返す Item の本文は `` で囲み、現在の active Task を `taskid` / `status` / `subject` を含む簡潔な形式で列挙する。`description` は長大化を避けるため省略してよい +- active Task が空の場合は何も append しない（思い出させる対象が無いなら不要） + +## 完了条件 + +- 直近 N リクエスト連続で `TaskCreate` / `TaskUpdate` が呼ばれず、かつ active Task が残っている場合に限り、`pending_history_appends` が `` を含む `Item::system_message` を 1件返す +- 返された Item が `worker.history` に append され、その後のリクエスト・`history.json`・resume 後の `get_history` でも同じ Item が見える（揮発レーンは持たない） +- `TaskCreate` / `TaskUpdate` のいずれかが呼ばれるとカウンタがリセットされ、再び N リクエスト経過するまでは reminder が出ない +- reminder が一度出たあとは、cooldown M リクエストが経過するまで再注入されない +- active Task が 0件の場合は reminder が出ない +- 単体テストで Interceptor の発火条件（リクエスト回数閾値、active 0件、cooldown）がカバーされる + +## 範囲外 + +- inprogress 滞留検出 / 多重 inprogress 検出など、状態異常ベースの追加トリガ（必要になれば別チケットで追加） +- system-reminder 注入機構の汎用化（`TODO.md` に立項済み、別途検討） +- `TaskCreate` / `TaskUpdate` の戻り値に active Task 全件を埋め込む強化（必要に応じて Tool ticket 側で対応） +- サブエージェント / sidechain での独自 reminder 発火（main Pod の interceptor から動く構造のため自然に対象外） + +## 参照 + +- 設計指針: `AGENTS.md`（LLM コンテキストの加工原則。揮発的注入は禁止、history に append してから commit する） +- 前提: `tickets/session-todo.md`（Tool 群と TaskStore）、`tickets/notify-history-persist.md`（`pending_history_appends` レーン） +- 参考: 一部エージェント実装の todo reminder は、一定リクエスト無アクティビティ後に発火し、再通知にも cooldown を置くナッジ型として扱われている + + +--- diff --git a/work-items/open/20260527-000011-session-todo-reminder/thread.md b/work-items/open/20260527-000011-session-todo-reminder/thread.md deleted file mode 100644 index 30b52b26..00000000 --- a/work-items/open/20260527-000011-session-todo-reminder/thread.md +++ /dev/null @@ -1,7 +0,0 @@ - - -## Migrated - -Migrated from tickets/session-todo-reminder.md. No legacy review file was present at migration time. - ----