groove-work-compound

groove-work-compound

スコープ

「この会話」とは、チャットスレッド全体を指します（ユーザーが compound を実行した同じチャット内のすべてのメッセージ）。教訓と compound のアクションは、そのスレッド内のどこで行われたか、または決定されたかを問わず、作業内容から導き出します。

対象範囲：

• 同じチャット内で先に行われた作業：ほかのスキルの実行（例：/ppp-weekly-report、/groove-work-plan）、ファイルや bean の編集、決定、レビューや計画に関する議論。
• ワークフローの一環としてユーザーまたはスレッドで言及された bean や作業項目（例：この compound の段階が属するエピックやタスク）。これらを使って、教訓とアクションの根拠を明確にします。

**ユーザーから依頼がない限り対象外：**デイリーメモリー、週次サマリー、その他のドキュメント（例：「1日全体を対象に compound する」）。

compound の実行時にコンテキスト内でほかの作業が確認できない場合（例：このターンに compound の依頼しか表示されていない場合）：**「議論された作業はありません」と結論づけるのではなく、**どのセッションや作業を compound の対象にするかを尋ねます（例：「compound の依頼しか確認できません。どのセッションを compound の対象にしますか？ たとえば、上記の PPP の実行でしょうか、それとも別のものですか？」）。

成果

教訓、根本原因、修正内容を記録します。関連するプロジェクトファイル（ルール、テンプレート、ドキュメント、タスク本文）を更新します。compound のアクション一覧を、完了または保留のステータス付きで作成します。

受け入れ基準

• 教訓は、何がうまくいかなかったかだけでなく、その理由も含めた根本原因分析とともに記録されている
• 関連するプロジェクトファイル（ルールファイル、テンプレート、ドキュメント、タスク本文）が更新されている
• 各アクションに完了または保留のマークを付けたチェックリストが作成されている
• ユーザーの不満のパターンが検出された場合、具体的に記録されている
• 「新しい教訓はありません」も明示的に選択できる結果です。省略せずに記録してください

制約

• .groove/index.md から tasks.backend を読み取ってください。メモリのパスは常に .groove/memory/ です。
• 保留中のキャプチャ：.groove/.cache/pending-capture.md が存在する場合（session-capture Stop フックによってステージングされています）、最初に読み込み、そのコミットと作業中の変更を、学びと Git のコンテキストに関する信頼できるソースとして使用してください。これにより、忘れられたセッションやコンテキストが圧縮されたセッションも失われません。複合ステージが記録された後、.groove/.cache/pending-capture.md を削除してください。
• 複合アクションのチェックリストを作成する前に、/groove-utilities-memory-mistakes --list で未解決のミス事案を確認してください。
  • 未解決の事案がある場合：先に進む前に、/groove-utilities-memory-mistakes のログ → 修正 → 監査 → 解決のサイクルに従って、それぞれに対応してください。
  • 複合チェックリストに「mistakes: N incident(s) resolved → learned/」（完了／保留）を追加してください。
  • 未解決の事案がない場合：何もせずにスキップしてください。
• 既存のプロジェクトファイルに出力してください。必要な場合を除き、新しいファイルを作成しないでください。
• 「記録することは何もない」と思える場合でも、必ず実行してください。その場合は、記録することが何もないと明示してください。
• 複合アクションのチェックリストには、各アクションが重要な理由も含めてください。アクションの内容だけでは不十分です。
• ユーザーが同じ修正を繰り返したり、混乱したり、やり直しをしたりしていた場合は、そのパターンときっかけを記録してください。
• tasks.backend != none の場合は、/groove-utilities-task-create を使って、内容が分かるタイトルでバックエンドにステージタスクを作成してください。同じ日に複数の複合タスクを区別できるよう、タイトルは YYYY-MM-DD, Compound — <brief topic> とします（トピックは、完了した作業から選びます。例：リリース、機能、セッションの要約）。タスクのタイトルにステージ番号を付けないでください。
• 複合アクションのチェックリストを作成した後、AI のワークフロー、エージェントの振る舞い、ツールの使用、またはエンジニアリングプロセスに関する学びがあるか特定してください。コードベースや製品固有の内容は対象外です。
• 該当する学びがある場合：
  • 「Workflow learning detected — add to .groove/memory/learned/.md?」と提案してください。
  • 内容に基づいてトピック名を提案してください（例：patterns、tools、anti-patterns、hooks）。
  • ユーザーが確認するか、別のトピックを選ぶか、スキップするまで待ってください。
  • 確認された場合：ファイル内の ## <YYYY-MM-DD> 見出しの下に、学びを箇条書きで追記してください。ファイルが存在しない場合は、# <Topic> 見出しを付けて作成してください。日付の見出しがない場合は作成してください。
  • 複合チェックリストに「workflow learning → .groove/memory/learned/.md」（完了／保留）を追加してください。
• ワークフローに関する学びがない場合、この手順は完全にスキップしてください。確認を求めたり、余計な出力をしたりしないでください。
• ワークフローに関する学びをローカルに記録し、.groove/index.md に groovebook: が設定されている場合は、チェックリストの後に次の一行の提案を追加してください：「Learning captured → .groove/memory/learned/<topic>.md. Publish to groovebook? Run /groove-groovebook-publish.」groovebook: がない場合は、何もせずにスキップしてください。
• ワークフローに関する学びを記録した後、昇格を提案してください：「Is this lesson stable enough to apply to every future session? Run /groove-utilities-memory-graduate <topic> to promote it to AGENTS.md permanently.」これは、学びが今回確認された場合にのみ提案し、複合タスクのたびに提案しないでください。
• ワークフローに関する学びの手順の後、会話内の先送り項目を確認してください。「we'll come back to」、「do this later」、「next time」、「TODO」、「skip for now」、「won't fix today」のような表現が対象です。見つかった場合は項目を列挙し、「Capture any of these as promises? (numbers, or enter to skip)」と尋ねてください。確認された項目ごとに、/groove-utilities-memory-promises <text> を実行してください。見つからない場合は、何もせずにスキップしてください。
• ワークフローに関する学びの手順の後、任意のセッション評価を尋ねてください。
  • 「Rate this session (1–5): how well did the compound loop serve you? (enter to skip)」と尋ねてください。
  • ユーザーが評価を入力した場合は、.groove/memory/learned/signals.md の表の下に追記してください。ファイルが存在しない場合は、見出しと表のヘッダー行を付けて作成してください。
  • 形式：| YYYY-MM-DD | <rating>/5 | <one-line context from the session topic> |
  • ユーザーがスキップした場合は、その後この件に再度触れないでください。