docs: memory prompt ticket policy ticket
This commit is contained in:
parent
e647d1a7c9
commit
df01d8e567
1
TODO.md
1
TODO.md
|
|
@ -27,6 +27,7 @@
|
||||||
- Prune: 保護境界を turn 数から末尾 token budget に置き換え → [tickets/prune-token-budget.md](tickets/prune-token-budget.md)
|
- 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)
|
- 使用頻度メトリクス + 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 ツールの注意機構(無アクティビティで `<system-reminder>` ナッジ) → [tickets/session-todo-reminder.md](tickets/session-todo-reminder.md)
|
- セッション内 Task ツールの注意機構(無アクティビティで `<system-reminder>` ナッジ) → [tickets/session-todo-reminder.md](tickets/session-todo-reminder.md)
|
||||||
- ワークスペースのメモリーをLintするヘッドレスCLI
|
- ワークスペースのメモリーをLintするヘッドレスCLI
|
||||||
- system-reminder 注入機構の汎用化(2件目の利用者が出た時に検討。タグ形式 `<system-reminder>...</system-reminder>` の規約は session-todo-reminder で先行確立。注入された Item は worker.history に append する方針)
|
- system-reminder 注入機構の汎用化(2件目の利用者が出た時に検討。タグ形式 `<system-reminder>...</system-reminder>` の規約は session-todo-reminder で先行確立。注入された Item は worker.history に append する方針)
|
||||||
|
|
|
||||||
46
tickets/memory-prompts-remove-ticket-policy.md
Normal file
46
tickets/memory-prompts-remove-ticket-policy.md
Normal file
|
|
@ -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`
|
||||||
Loading…
Reference in New Issue
Block a user