catchup

キャッチアップ分析手法

概要

Git リポジトリの最近の変更、議事録、スプリントの進捗、ドキュメントの改訂、システムログをすばやく把握するための体系的な手法です。「何が変わり、何が重要か？」に効率よく答えます。

使用する場面

• 進行中の作業に参加するとき、または休止後に作業へ戻るとき
• 計画や引き継ぎのレビューを行う前
• 「何が起きて、次に何をするか」という状況を把握したいとき

使用しない場面

• 詳細な 差分分析を行う場合は、代わりに diff-analysis を使用します
• コードレビュー全体が必要な場合
  • 代わりに review-core を使用します

起動

キーワード：catchup、summary、status、progress、context、handoff 手がかり：「状況を把握したい」「現在の状況」「進捗を要約して」

段階的な読み込み

状況に応じてモジュールを読み込みます：

Git：Git コマンドについては modules/git-catchup-patterns.md を読み込みます。初期データの収集には sanctum:git-workspace-review の使用を検討します。

ドキュメント／メモ：議事録、スプリントの追跡、ドキュメントの改訂については modules/document-analysis-patterns.md を読み込みます。

ログ／イベント：時系列データとメトリクスの分析については modules/log-analysis-patterns.md を読み込みます。

常時利用可能：imbue:proof-of-work、進捗項目のワークフロー、構造化出力。

必須の進捗項目

1. catchup:context-confirmed - 範囲を確定
2. catchup:delta-captured - 変更を列挙
3. catchup:insights-extracted - テーマを特定
4. catchup:followups-recorded - 対応事項を記録

4 ステップの手法

ステップ 1：コンテキストを確認

範囲（Git ブランチ、スプリント、会議）、基準点（前回の状態）、現在の対象を定義します。コマンドについてはモジュールを参照してください。

ステップ 2：差分を把握

変更項目をメトリクスとともに列挙します。生成された成果物よりも、ソース／設定／ドキュメントを優先します。手法についてはモジュールを参照してください。

ステップ 3：洞察を抽出

項目ごとに、内容（変更点）、理由（動機）、影響（テスト／リスク／依存関係）を整理します。最後にテーマごとにまとめます。

ステップ 4：対応事項を記録

テスト、ドキュメント、レビュー、ブロッカー、質問を記録します。何もなければ、その旨を明記します。

出力形式

## Summary
[2-3 sentence theme + risk overview]

## Key Changes
- [Item]: [what/why/implication]

## Follow-ups
- [ ] [Action with owner]

## Blockers/Questions
- [Item requiring resolution]

検証： --help フラグを付けてコマンドを実行し、利用可能であることを確認します。

統合

リスク評価には imbue:diff-analysis、再現性の確保には imbue:proof-of-work、Git データの取得には sanctum:git-workspace-review を使用します。必要に応じて brainstorming または writing-plans に渡します。

トークンの節約

パスと行番号を参照し、内容を再掲しないでください。出力を要約します。詳細な分析は後回しにします。段階的な読み込みを使用します。

完了条件

• 4 つすべての catchup: 進捗項目が完了としてマークされている
• Summary に、比較対象の基準点として Git の ref、日付、またはドキュメントのバージョンが記載されている
• Key Changes に、変更された各領域とファイルパスまたはソースの参照が記載されている
• Follow-ups と Blockers/Questions が記載され、それぞれ内容が記入されているか「なし」と明記されている