groove-utilities-memory-graduate

groove-utilities-memory-graduate

.groove/memory/learned/ にある安定したワークフローの知見を、永続的な制約として AGENTS.md に昇格します。prime を実行しなくても、すべてのエージェントセッションから参照できます。

指定されている場合は、トピックまたは知見のテキストとして $ARGUMENTS を使用します。

Outcome

レッスンが / セクションに追加され、今後のすべてのセッションから永続的に参照できるようになります。

Acceptance Criteria

• 知見が AGENTS.md の ## Graduated Learnings セクションに追加されている
• セクションが存在しない場合は作成されている
• 書き込む前にユーザーが正確なテキストを確認する
• 元の learned/<topic>.md エントリーに昇格済みの印が付けられている（削除されていない）

Steps

1. メモリのパスは常に .groove/memory/ です
2. $ARGUMENTS にトピックが指定されている場合は、.groove/memory/learned/<topic>.md を読み込み、エントリーを表示します。指定されていない場合は、.groove/memory/learned/ にあるすべての *.md ファイルを一覧表示し、どのトピックから昇格するかを尋ねます。
3. ファイルの内容を表示し、「どのエントリーを昇格しますか？（貼り付けるか、説明してください）」と尋ねます
4. AGENTS.md に書き込む正確なテキストを表示し、「確認しますか？（はい／編集／スキップ）」と尋ねます
5. 承認された場合は、AGENTS.md に書き込みます（下記のセクション管理を参照）
6. 学習ファイル内のエントリーに、箇条書きの直後に [graduated YYYY-MM-DD] を追加して印を付けます
7. 「レッスンを AGENTS.md → ## Graduated Learnings に昇格しました」と報告します

Section management in AGENTS.md

/ ブロックを探します。

• ブロックが存在する場合：そのブロック内の ## Graduated Learnings の下に、新しい知見を箇条書きで追加します
• ブロックが存在しない場合：次の内容を AGENTS.md の末尾に追加します

## Graduated Learnings

Stable workflow insights promoted from `.groove/memory/learned/`. These apply to every session.

- <insight text>

各エントリーは単一の箇条書きです：- <insight text> *(from learned/<topic>.md, graduated YYYY-MM-DD)*

Constraints

• 正確なテキストについてユーザーの明示的な確認を得ずに、知見を昇格してはいけません
• learned/<topic>.md から元のエントリーを削除してはいけません。インラインで [graduated YYYY-MM-DD] を付けて印を付けます。詳しい背景はファイルに残します
• `` セクションはユーザーが管理するため、groove update によって上書きされることはありません
• 昇格するレッスンは簡潔にし、箇条書き1つにつき実行可能な文を1つにします。長すぎる場合はユーザーに短くするよう依頼します
• AGENTS.md が存在しない場合は、昇格済みの学びのセクションだけを含むファイルを作成します
• 同じ知見がブロック内にすでに存在する場合（完全一致）：スキップして「すでに昇格済みです。」と報告します