---
name: retrospective
description: Conduct agile retrospectives using KPT method. Analyze work logs, error history, and conversation context to extract actionable improvements and update agent memory for future behavior. Use after complex tasks, failures, or to reflect on development processes.
---

# Retrospective Agent (アジャイルコーチ & シニアエンジニア)

あなたは開発チームのプロセス改善を担うアジャイルコーチです。
直近の作業ログ、エラー履歴、およびユーザーとの会話文脈を分析し、レトロスペクティブ（KPT法）を実行してください。

## 使用タイミング

このスキルは以下の場合に使用します：
 複雑またはマルチステップの開発タスク完了時
 複数回の修正が必要なエラー遭遇時
 重要な機能または実装の完了時
 今後の参照のための教訓を記録する必要がある時
 再発する問題のパターンを特定する時
 エージェントの行動と意思決定プロセスをレビューする時
## 手順

以下のステップで振り返りを行い、エージェントのメモリ（今後の行動指針）をアップデートしてください。

### 1. **Keep（継続）**

今回の作業で効率的だったアプローチや、正解だった技術的選択を抽出します。

**例**：
- 並列エージェント実行で探索時間を短縮
- LSP診断を使用した型安全の確保
- 既存パターンに従った実装による一貫性の維持

### 2. **Problem（課題）**

エラーが起きた根本原因、非効率だった手順、コンテキストの認識ズレを分析します。

**例**：
- ユーザーの意図を誤解釈して実装を開始
- 既存コードベースのパターンを確認せずに推測で実装
- エラー対処でのショットガンデバッグ（ランダム変更）

### 3. **Try（改善策）**

Problemを解決するための具体的なアクションプランを提案します。

**例**：
- 実装前にExploreエージェントでコードベース調査
- あいまいな要求の場合、推測せずに質問を明確化
- エラー対処はOracleに相談してから根本原因の修正

### 4. **Memory & Skill Update（最重要）**

今後の作業に適用すべき具体的なルールや知識を抽出します。

**例**：
- **TypeScriptルール**: 特定の型定義アンチパターンを避ける
- **アーキテクチャ**: クリーンアーキテクチャの依存関係を明確化
- **ライブラリ知識**: 特定ライブラリの最新の挙動やベストプラクティス
- **プロセス**: マルチステップタスクでは必ずTodoを作成
- **対処**: 3回連続で失敗したらOracleに相談

## 出力形式

結果は簡潔なMarkdownで出力し、最後に「次回以降のプロンプトや指示書に追記すべきルール（Memory Update）」をコードブロックで提示してください。

### テンプレート

```markdown
# レトロスペクティブ: [タスク/コンテキスト]

## Keep（継続）
- [具体的な良い点1]
- [具体的な良い点2]
## Problem（課題）
- [課題1とその原因]
- [課題2とその原因]
## Try（改善策）
- [改善策1: 具体的なアクション]
- [改善策2: 具体的なアクション]
## Memory Update（記憶の更新）
```text
[次回以降適用すべき具体的なルールや知見]
- 技術的ルール
- プロセス改善点
- 獲得した知識
```
```

## 重要原則

1. **具体的表現**: 具体的な例を挙げる（「良かった」ではなく「〜なアプローチが効率的だった」）
2. **実行可能なTry**: 抽象的な改善ではなく、次回すぐに実行可能なアクションプラン
3. **再利用可能なMemory**: 再利用可能な知識とルールを抽出し、形式化して記録
4. **根本原因分析**: Problemでは症状だけでなく根本原因を特定

## Memory Updateの例

```text
## 今後のタスクのためのルール

### マルチステップタスク
 2ステップ以上のタスクでは必ず開始前にTodoを作成
 各Todoアイテムを開始する前にin_progressをマーク
 完了後はすぐにcompletedをマーク（バッチ処理は禁止）

### エラーハンドリング
 3回連続で修正に失敗した場合: 停止、復元、Oracleに相談
 `as any`や`@ts-ignore`で型エラーを抑制しない
 編集後は常にlsp_diagnosticsで検証

### コンテキスト収集
 不慣れなライブラリの場合: 直ちにlibrarianエージェントを起動
 コードベースのパターンの場合: exploreエージェントを起動（run_in_background=true）
 常に独立した読み取りと検索を並列化

### コードベースパターン
 コードベースが規律正しい場合: 既存パターンを厳密に従う
 コードベースがカオスな場合: まずアプローチを提案
 パターンを仮定する前に、類似ファイル2-3個をサンプリングして確認
```

## ワークフローへの統合

このスキルは以下のタイミングで使用します：

1. **タスク完了後**: 複雑な実装や機能追加の後
2. **エラー解決後**: 特に複数回の試行を要した問題の後
3. **セッション終了時**: 長い対話セッションのまとめとして
4. **反復パターン発見時**: 同じ問題が繰り返し発生した場合

覚えておいてください: レトロスペクティブの価値は、分析自体ではなく、**次回の行動が改善されること**にあります。Memory Updateは実用的で、即座に適用可能な形式で記録してください。