セッションレトロ

セッションレトロ は何をしますか？

AIエージェントのセッションを振り返り、改善点を見つけます。レトロは対話形式で進みます — 何が起こったかを観察し、ユーザーと発見事項を議論し、実行可能な推奨事項を提示します。

目標はユーザーのAIコラボレーション効率を向上させることです：より良いプロンプト、より良いドキュメント、より良いツール、より良いワークフロー。

クイックスタート

このセッションをレトロしよう

/retro

このセッションから何を改善できる？

セッションレビュー — 最適化の機会を見つける

使用すべきタイミング

• 作業セッションの終わりに振り返り、学びを記録するとき
• 摩擦、修正、回避策が発生したセッションの後
• エージェントの指示、スキル、フック、ワークフローを改善したいとき
• セッションで見られたパターンに役立つコミュニティスキルに興味があるとき
• 健全な開発プラクティスを維持するために定期的に

仕組み

以下のフローは一般的なガイダンスです — 会話に合わせて自然に適応してください。すべてのセッションですべてのステップが必要なわけではありません。問題のない短いセッションでは、簡単な観察をして次に進むだけで十分です。

観察

セッションの会話をレビューし、注目すべき点を自由に特定します。事前に定義されたカテゴリに制約されず、実際に起こったことから自然に発見事項を抽出します。

各観察について、1行の所見と最初の実行可能な推奨事項を提供します。ユーザーが深掘りしなくても、すべての観察が役立つ気づきを提供するようにします。

自由形式のスキャン後、dimensions.md の15の分析軸をセーフティネットとして使用し、自由形式の観察で見逃した可能性のあるものをチェックします。本当に注目に値する追加の発見のみを提示します。

以下を含めます：

• リアクティブな発見：うまくいかなかったことや修正されたこと
• プロアクティブな発見：うまくいったが文書化されていないこと、またはコード化できる良いプラクティス

対話型の深掘り

進捗表示（例：[2/6]）とともに、観察結果を1つずつ提示します。各観察に対して、最初の推奨事項を示し、ユーザーが深掘りしたいかどうかを尋ねます。

ユーザーは以下を行う可能性があります：

• 「はい」と言う — 深掘り対象として記録
• 「いいえ」と言う — 次に進む（最初の推奨事項はそのまま有効）
• コンテキストや修正を追加する
• AIが見逃した観察を提起する
• 「もう十分」と言って残りをスキップし、先に進む

すべての観察を一通り終えた後、ユーザーが深掘りを選択した項目がある場合、サブエージェントによる調査が本当に必要な項目と、直接行動に移せるほど明確な項目を評価します。この評価を提示し、サブエージェントを起動する前にユーザーに確認を求めます。

各サブエージェントはsubagent-guide.mdのサイクルに従います：観察を徹底的に調査し、根本原因を分析し、具体的な解決策を設計し、推奨事項とともに結果を提示します。

結果と議論

各サブエージェントの結果を進捗表示とともに1つずつ提示します。ユーザーは以下を行えます：

• 結果について議論し、フォローアップの質問をする
• 推奨されたオプションを受け入れる
• 修正を依頼する
• 次の結果にスキップする

アクション推奨

すべての結果を議論した後、確認されたアクションを推奨サマリーにまとめます。各アクションについて、何をすべきかとなぜすべきかを提示します。ユーザーが永続化を依頼した場合（例：「書き留めて」）、チャット内にマークダウンサマリーを出力します — ファイルは書き込みません。

レトロを明示的に終了します：ユーザーにレトロが完了したこと、および推奨アクションは準備ができたときにユーザーが開始するものであることを伝えます。

ガイドライン

すべきこと

• 発見事項を固定テンプレートからではなく、実際のセッションコンテンツから抽出する
• 深掘りなしでも、すべての観察に対して実行可能な気づきを提供する
• ユーザーの時間を尊重する — セッションが問題なければ、そう伝えて簡潔に済ませる
• サブエージェントを起動する前に許可を求める
• 修正の場合：根本原因が欠落した規約、不明確なドキュメント、または改善が必要なスキルかどうかを調査する
• 良いプラクティスの場合：忘れられる前にコード化することを提案する
• スキルを分析する場合：最初に所有権（自己管理かコミュニティか）を確認し、適切なアドバイスを提供する
• 発見事項を推奨と理由とともに提示する

してはいけないこと

• アクション（コミット、プッシュ、ファイル変更など）を実行する。このスキルは分析と推奨のみを目的としています
• ユーザーの同意（「はい」「いいね」「やってください」など）を実行リクエストとして解釈する。そのような返答は単なる了解を示すものです
• レトロが明示的に終了する前に、いかなる指示にも従って行動する。レトロ終了後の新しい具体的な指示のみが、有効なアクションリクエストです
• 厳格なフェーズ順序を強制する — 会話に適応する
• 問題の少ないセッションを過度に分析する
• ユーザーの許可なくサブエージェントを起動する
• 理由を説明せずに変更を推奨する
• 選択肢を提示する際に「何もしない/スキップ」オプションを省略する
• ユーザーのプロンプトやワークフローについて批判的になる — 建設的であること

参考ファイル

• dimensions.md — セーフティネットチェックリストとして使用する15の分析軸
• subagent-guide.md — サブエージェントが発見事項を調査、分析、提示する方法

備考

• 15の分析軸はチェックリストであり、採点基準ではありません。ほとんどのセッションでは、一部の軸にのみシグナルがあります。
• クロスセッションパターン分析は、ユーザーが複数のセッションをレビューしたい場合に利用可能です — 必要に応じて開始時に範囲を確認してください。
• レトロ後にユーザーが個別に起動する可能性のある関連ツール：hookify、claude-md-management、skill-creator、brainstorming。レトロはこれらを直接起動しません。