From df01d8e567a69d9e4471c07f18f125404bf3dedf Mon Sep 17 00:00:00 2001 From: Hare Date: Sun, 10 May 2026 01:13:57 +0900 Subject: [PATCH] docs: memory prompt ticket policy ticket --- TODO.md | 1 + .../memory-prompts-remove-ticket-policy.md | 46 +++++++++++++++++++ 2 files changed, 47 insertions(+) create mode 100644 tickets/memory-prompts-remove-ticket-policy.md diff --git a/TODO.md b/TODO.md index 33e47884..7cbfa1e3 100644 --- a/TODO.md +++ b/TODO.md @@ -27,6 +27,7 @@ - Prune: 保護境界を turn 数から末尾 token budget に置き換え → [tickets/prune-token-budget.md](tickets/prune-token-budget.md) - メモリ機構 - 使用頻度メトリクス + Knowledge 化候補レポート → [tickets/memory-usage-metrics.md](tickets/memory-usage-metrics.md) + - Prompt から project-specific ticket shadow policy を外す → [tickets/memory-prompts-remove-ticket-policy.md](tickets/memory-prompts-remove-ticket-policy.md) - セッション内 Task ツールの注意機構（無アクティビティで `` ナッジ） → [tickets/session-todo-reminder.md](tickets/session-todo-reminder.md) - ワークスペースのメモリーをLintするヘッドレスCLI - system-reminder 注入機構の汎用化（2件目の利用者が出た時に検討。タグ形式 `...` の規約は session-todo-reminder で先行確立。注入された Item は worker.history に append する方針） diff --git a/tickets/memory-prompts-remove-ticket-policy.md b/tickets/memory-prompts-remove-ticket-policy.md new file mode 100644 index 00000000..dbb09760 --- /dev/null +++ b/tickets/memory-prompts-remove-ticket-policy.md @@ -0,0 +1,46 @@ +# Memory prompts: project-specific ticket shadow policy を外す + +## 背景 + +現在の bundled memory prompts は、INSOMNIA 自身の開発運用に由来する「ticket / TODO / worktree / commit は git が正本なので memory に記録しない」という規則を、一般ユーザーの workspace にも適用している。 + +特に `resources/prompts/internal/memory_extract_system.md` と `resources/prompts/internal/memory_consolidation_system.md` には、ticket file 作成・編集、TODO 更新、ticket 名、worker Pod spawn for ticket などを memory から落とす指示が明示されている。しかし ticket はこのプロジェクト固有の管理手法であり、insomnia の利用者に押し付けるほど汎用的・成熟した概念ではない。 + +このため、memory がユーザー workspace の実際の管理対象や作業文脈を過剰に捨てる可能性がある。デフォルト prompt は、INSOMNIA リポジトリ固有の ticket 運用ではなく、より一般的な「既存の正本をそのまま重複保存しない」程度の方針に留めるべきである。 + +## 要件 + +- bundled memory prompts から、INSOMNIA プロジェクト固有の ticket / TODO 運用を前提にした禁止文言を削除する + - `ticket-file creation / edit` + - `TODO updates` + - `ticket Y was created` + - `ticket file names` + - `worker Pod was spawned for Z` が ticket 前提で語られている箇所 +- `git is authoritative` の扱いを、一般ユーザーに押し付けない表現へ弱める + - git / VCS に残る単なるファイル操作ログを memory が逐語的に shadow しない、という原則は残してよい + - ただし project management 上の出来事や管理ファイルの内容が、将来の作業判断に効くなら memory へ抽象化して残せる余地を残す +- Phase 1 extract prompt と Phase 2 consolidation prompt の両方を整合させる +- 必要なら `docs/plan/memory-prompts.md` または `docs/plan/memory.md` に、default prompt は特定プロジェクトの ticket 運用を前提にしないことを明記する +- INSOMNIA 自身の運用で ticket shadow を避けたい場合は、bundled default ではなく workspace/user prompt override 側で表現できる状態にする + +## 範囲外 + +- memory の file format / linter / Phase 1 / Phase 2 実行機構の変更 +- 使用頻度メトリクスや Knowledge 化 gate の実装 +- INSOMNIA プロジェクト自身の ticket 運用の再設計 +- prompt override 機構そのものの変更 + +## 完了条件 + +- `resources/prompts/internal/memory_extract_system.md` から ticket / TODO 固有の shadow 禁止が消えている +- `resources/prompts/internal/memory_consolidation_system.md` から ticket / TODO 固有の shadow 禁止が消えている +- 代替文言が、特定管理手法ではなく「既存の正本と重複しない」「将来の判断に効く抽象だけ残す」という一般原則になっている +- default prompt が、ユーザー workspace の project management 手法を固定しない +- 既存テスト / prompt catalog 検査が通る + +## 参照 + +- `resources/prompts/internal/memory_extract_system.md` +- `resources/prompts/internal/memory_consolidation_system.md` +- `docs/plan/memory-prompts.md` +- `docs/plan/memory.md`