recall-reasoning

過去の作業を振り返る

過去のセッションを検索して、関連する判断、うまくいったアプローチ、失敗したアプローチを見つけます。次の 2 つの情報源を検索します。

1. アーティファクトインデックス - 事後分析（うまくいったこと／失敗したこと）を含む引き継ぎ資料、計画、台帳
2. 推論ファイル - ビルドの試行、テストの失敗、コミットのコンテキスト

使用するタイミング

• 過去のセッションと似た作業を始めるとき
• 「前回 X について何をしたか？」を確認するとき
• 以前うまくいったパターンを探すとき
• ある方法が選ばれた理由を調べるとき
• 過去に遭遇した問題をデバッグするとき

使用方法

優先：アーティファクトインデックス（豊富なコンテキスト）

uv run python scripts/core/artifact_query.py "<query>" [--outcome SUCCEEDED|FAILED] [--limit N]

事後分析（うまくいったこと、失敗したこと、重要な判断）を含む引き継ぎ資料を検索します。

補助：推論ファイル（ビルドの試行）

bash "$CLAUDE_PROJECT_DIR/.claude/scripts/search-reasoning.sh" "<query>"

.git/claude/commits/*/reasoning.md を検索して、ビルドの失敗と修正を確認します。

例

# Search for authentication-related work
uv run python scripts/core/artifact_query.py "authentication OAuth JWT"

# Find only successful approaches
uv run python scripts/core/artifact_query.py "implement agent" --outcome SUCCEEDED

# Find what failed (to avoid repeating mistakes)
uv run python scripts/core/artifact_query.py "hook implementation" --outcome FAILED

# Search build/test reasoning
bash "$CLAUDE_PROJECT_DIR/.claude/scripts/search-reasoning.sh" "TypeError"

検索対象

アーティファクトインデックス（引き継ぎ資料、計画、台帳）：

• タスクの概要とステータス
• うまくいったこと - 成功したアプローチ
• 失敗したこと - 行き詰まった方法とその理由
• 重要な判断 - 根拠を伴う選択
• 台帳に記載された目標と制約

推論ファイル（.git/claude/）：

• 失敗したビルドの試行とエラー出力
• 失敗後に成功したビルド
• コミットのコンテキストとブランチ情報

結果の解釈

アーティファクトインデックスの場合：

• ✓ = 成功した結果（参考にするパターン）
• ✗ = 失敗した結果（避けるべきパターン）
• ? = 不明な結果（まだマークされていません）
• 事後分析のセクションには、整理された学びが記載されています

推論ファイルの場合：

• build_fail = うまくいかなかったアプローチ
• build_pass = 最終的に成功した方法
• 成功前に複数回失敗している場合 = 単純ではない問題

手順

1. まずアーティファクトインデックスを検索します - より豊富なコンテキストと事後分析を確認します
2. 関連する引き継ぎ資料を確認します - うまくいったこと／失敗したことのセクションを確認します
3. 必要に応じて推論ファイルを検索します - 特定のビルドエラーを調べます
4. 学びを活用します - 成功したパターンに従い、失敗したパターンを避けます

結果が見つからない場合

アーティファクトインデックスが空の場合：

• uv run python scripts/core/artifact_index.py --all を実行して、既存の引き継ぎ資料をインデックス化します
• 今後の振り返りに備えて、事後分析セクションを含む引き継ぎ資料を作成します

推論ファイルが空の場合：

• ビルド後に /commit を使って推論を記録します
• .git/claude/ ディレクトリがあるか確認します