groove-utilities-memory-mistakes

groove-utilities-memory-mistakes

$ARGUMENTS が指定されている場合は、間違いの説明として使用します（例：--list を指定すると、未解決のインシデントのみが表示されます）。

成果

ワークフロー上の間違いが記録され、該当するメモリまたは学習済みファイルで根本原因が修正され、その教訓が .groove/memory/learned/<topic>.md に昇格されます。インシデントはクローズされます。

受け入れ条件

• 根本原因と修正内容を含めてインシデントが記録されている
• .groove/memory/learned/<topic>.md に恒久的な修正が適用されている
• インシデントが解決済みとしてマークされている

タスクバックエンド

.groove/index.md から tasks.backend を読み込みます。インシデントは、設定されたバックエンドでタスクとして追跡されます。タスクバックエンドが設定されていない場合（tasks.backend: none）、まず /groove-utilities-task-install を実行するようユーザーに伝えます。

インシデントは、共有の「Groove Memory」マイルストーン → 「Mistakes」エピックの下にバグとして保存されます。

親階層を確保する

操作の前に、親エピックを解決するか作成します。

1. 「Groove Memory」マイルストーンを検索または作成します。
   • beans list -t milestone --search "Groove Memory" -q を実行します。結果が空でなければ、最初の ID を使用します。空の場合は、beans create "Groove Memory" -t milestone を実行します。
2. そのマイルストーンの下に「Mistakes」エピックを検索または作成します。
   • beans list -t epic --parent <milestone-id> --search "Mistakes" -q を実行します。結果が空でなければ、最初の ID を使用します。空の場合は、beans create "Mistakes" -t epic --parent <milestone-id> を実行します。

--list

1. <parent-id> を解決します。
2. beans list --parent <parent-id> -t bug -s in-progress を実行します。
3. 次の形式の番号付きリストで表示します：1. [<id>] <title>
4. 結果が空の場合は、「未解決のインシデントはありません。」と表示します。

インシデントの記録と解決

1. <parent-id> を解決します。
2. $ARGUMENTS から説明を取得するか、「どのような間違いをしましたか？」と尋ねます。
3. 「根本原因 — なぜ起きたのでしょうか？」と尋ねます（状況に応じて提案し、ユーザーに確認します）。
4. 「どのような修正を適用しますか？」と尋ねます（提案し、ユーザーに確認します）。
5. beans create "<description>" -t bug --parent <parent-id> -s in-progress を実行します。
6. 修正をすぐに適用します（該当するファイルを編集します）。
7. 「どの学習済みトピックにしますか？（例：anti-patterns、tools）」と尋ねます。根本原因に基づいて候補を提案します。
8. .groove/memory/learned/<topic>.md の ## YYYY-MM-DD 見出しの下に教訓を追記します。
9. beans update <id> -s completed を実行します。
10. 「インシデントを解決しました → learned/.md」と報告します。

制約

• .groove/index.md から tasks.backend を読み込みます。メモリのパスは常に .groove/memory/ です。
• 設定済みのタスクバックエンドが必要です。tasks.backend: none の場合は、インストールするようユーザーに案内します。
• ユーザーの確認なしにインシデントを自動作成してはいけません。
• 解決前に根本原因を確認する必要があります。監査手順を省略してはいけません。
• 親階層は冪等です。作成前に必ず存在を確認します。
• 修正対象が skills/ ファイルの場合、skills/ は groove:update によって管理されていることを伝え、修正先を learned/anti-patterns.md に変更します。