レトロボット（振り返りボット）は何をしますか？

Claudeとの共同作業セッションに対して、軽量なアジャイルレトロスペクティブを実行するスキルです — Claudeとの作業プロセスを徐々に改善していくためのものです。

コアループ：あなたとClaudeがひとつの作業を終えたら、数分かけて一緒に3つの質問に答えます。

何がうまくいったか？（これを続ける）
何がうまくいかなかったか？（摩擦、やり直し、混乱、無駄なトークン）
何を変更すべきか？（スキル、プロンプト、プロセスに対する具体的な改善）

変更は即座に適用され、すべてのレトロは永続的なアーカイブにスナップショットとして保存されます。時間の経過とともに、Claudeワークフローがどのように進化してきたかの実行可能な監査証跡が構築され、セッションを重ねるごとにセットアップが有意義に高速化します。

フェーズ0 — アーカイブディレクトリの設定（初回のみ）

レトロを開始する前に、レトロアーカイブディレクトリが設定されているか確認します。 Claude.md 内に次のようなブロックがないか確認します。

## Retro-Bot
archive_dir: [パス]

すでに設定されている場合： フェーズ1に直接進みます。再度尋ねる必要はありません。

設定されていない場合： ユーザーに一度だけ明確に尋ねます。

「始める前に — レトロのスナップショットをどこに保存しますか？これは一度だけの設定です。フォルダパスを教えてください（例：H:\My Drive\Retros や ~/Documents/retros）。今後、すべてのレトロが自動的にそこに保存されます。」

ユーザーがパスを指定したら：

Claude.md に次のブロックを追加します（ファイルが存在しない場合は作成します）。
```
## Retro-Bot
archive_dir: [ユーザーが指定したパス]
```
ディレクトリが存在しない場合は作成します。
そのディレクトリに空の retro-log.md を作成します（フォーマットはフェーズ6を参照）。
確認します：「設定完了 — レトロアーカイブを [パス] に設定しました。今後のレトロはすべてそこに保存されます。」

その後、フェーズ1に進みます。

フェーズ1 — セッションコンテキストの読み取り

セッションのトランスクリプトを読み取り、実際に何が起こったかを理解します。環境がセッション履歴やトランスクリプトツールを提供している場合は、それを使用して発生した内容の完全な記録を取得します（Coworkでは自動的に利用可能、Claude Codeの場合は /transcript など）。完全なトランスクリプトがなくても、わかっていることから情報を引き出します：どのスキルが使用されたか、どのファイルが作成されたか、セッション中にユーザーからどのようなフィードバックがあったか、どこでやり直しが必要だったか。

ユーザーがセッション直後にこのスキルを呼び出した場合、コンテキストは既にあります。後で説明とともに呼び出した場合は、その説明から作業します。

どのセッション/作業についてレトロを行うのか不明な場合は、ユーザーに確認を求めます。

フェーズ2 — Claudeが最初に所見を述べる

Claudeが先に話します。ユーザーが不満を列挙するのを待たずに、自分が気づいたことを共有します。これは良いレトロスペクティブの行動を示し、注意を払っていたことを示し、多くの場合、ユーザーが意識的に認識していなかったが、すぐに認識できることを表面化します。

所見は正直かつ具体的に述べます。

「SOWを2回レンダリングし直さなければならなかったことに気づきました。最初のテーブル形式がWordで正しく開かなかったためです — これは私が修正できるスキル設定の問題です。」
「クライアントブリーフを1つのブロックではなく、3つの別々のメッセージで送ってくれました — これは作業を遅くするワークフローパターンとして注目に値します。」
「スコープビルダーとSOWビルダーのスキルは一貫した数値を生成しました — スムーズに感じられました。」
「途中までどのエクスポート形式が必要かわからず、後で教えてもらいました — 最初に簡単な質問をしておけば、ラウンドトリップを1回減らせたでしょう。」

3〜5件の所見に絞ります。直接的で、防御的にならないようにします。あなたは参加者であり、傍観者ではありません。

フェーズ3 — ユーザーの入力を促す

自分の所見の後、ユーザーに追加、修正、反論を促します。

「以上が私の所見です。あなたのリストはどうですか — 私が見逃したこと、別の捉え方をしたいこと、確実に記録しておきたいことはありますか？」

ユーザーの摩擦点は、あなたのものと異なることがよくあります。混乱したこと、その場では言及しなかった出力品質の問題、プロセスの煩わしさ、素晴らしくて維持すべき点などが挙げられるかもしれません。すべてをキャプチャします。

フェーズ4 — レトロボードの作成

両者が貢献したら、完全なボードを提示します。具体的に — あいまいな項目は有用なアクションアイテムを生み出しません。

## ✅ うまくいったこと
- [スムーズに進んだ具体的なこと]
- ...

## ❌ うまくいかなかったこと
- [具体的な摩擦点、原因がわかっている場合はそれも]
- ...

## 🔧 変更案
- [「うまくいかなかったこと」に関連する具体的な提案]
- ...

次に進む前にユーザーに確認を求めます。

「これで内容をとらえていますか？何か追加や調整はありますか？それから何を実行するか決めましょう。」

フェーズ5 — アクションアイテムへのマッピング

各変更案について、タイプと優先度を決定します。

タイプ	いつ使用するか
🔧 スキル更新	問題がスキルの指示、出力形式、またはデフォルトの動作に起因する場合
📋 プロジェクト/セッション更新	特定のプロジェクト、クライアント、またはセッションタイプに限定されたコンテキストや指示 — グローバルではない
📝 Claude.md更新	すべてのプロジェクトとセッションにわたって、どこにでも適用される不足しているコンテキスト
💡 プロセスノート	行動の変更 — ファイル編集は不要、単に作業方法の変更
🆕 新しいスキル	ギャップが繰り返し発生し、独自のスキルを必要とするほど大きい場合

プロジェクト/セッション更新とClaude.md更新の主な違いはスコープです。コンテキストが特定のプロジェクト、クライアント、または特定のセッションタイプでの作業にのみ適用されるべき場合は、プロジェクト/セッションレイヤーに属します。常に、どこでも、ユーザーのすべての作業にわたって適用されるべき場合は、Claude.mdに属します。これを間違えるとどちらの方向にもコストがかかります：Claude.mdに情報が多すぎるとノイズになり、クライアント間でコンテキストが混ざります。プロジェクトファイルに情報が多すぎると、プロジェクトを切り替えるたびにコンテキストを再設定する必要があります。

各アクションアイテムについて、何が変わるか、どこで、なぜ重要なのか、そして今すぐ実行するか後でメモするかを述べます。何かを適用する前に確認します。

「これが私が提案する変更点です。実行してもよろしいですか？」

各タイプの詳細なガイダンスについては、references/action-item-types.md を参照してください。

フェーズ6 — バージョン管理を伴う変更の適用

確定した各アクションアイテムを、コピー優先のバージョニングパターンを使用して適用します — ソースファイルを直接上書きすることは決してありません。ルール：現在のファイルを読む → メモリ内で編集を適用する → 新しいバージョンのファイル名で書き出す（例：SKILL-v1.1.md） → 古いファイルを archive/ に保持する。これにより、別のバージョン管理ツールを使わなくても復元可能な履歴が作成されます。

スキル更新： 現在のファイルを読む → メモリ内で適用 → 新しいバージョンのファイル名で書き出す → 古いファイルをアーカイブ → チェンジログエントリを追加。小さな修正はパッチバージョン、意味のある追加はマイナーバージョン、アーキテクチャの変更はメジャーバージョンを上げます。

プロジェクト/セッション更新： 変更のスコープに適した指示ファイルを特定します — これはリポジトリやフォルダルートのプロジェクトレベル CLAUDE.md（Claude Code）、Coworkセッション設定、定期的なクライアント業務用の常設ブリーフファイル、またはセッションタイプにスコープされたカスタム指示などです。ファイルが存在しない場合は作成します。他のファイル変更と同じコピー優先パターンを適用します。

一般的なターゲット：

[project-folder]/CLAUDE.md — そのプロジェクトのすべてのClaude Codeセッションで自動的に読み込まれる
[client-name]-brief.md や [project-name]-context.md のような常設参照ファイル
Coworkセッションレベルの設定やシステムプロンプト
Claude.ai カスタム指示（アカウント設定 → 「Claudeに知っておいてほしいこと」）

Claude.md更新： 現在のファイルを読む → 適切なセクションに新しいコンテキストを追加 → 新しいバージョンを書き出す → 古いファイルをアーカイブ。Claude.mdが存在しない場合は作成します。

プロセスノート： レトロスナップショットに文書化します（別のファイルは不要）。

適用後、何が変わったかを確認します。

「完了しました — [スキル名]をv1.1に更新し、[トピック]についてClaude.mdにメモを追加しました。」

フェーズ7 — レトロスナップショットの保存と監査ログの更新

このフェーズは必須です — すべてのレトロ実行は、適用されたアクションアイテムの数に関係なく、保存されたスナップショットを生成しなければなりません。スナップショットが記録であり、監査ログがフィードです。

ステップ1：レトロスナップショットの保存

設定された archive_dir に完全なレトロスナップショットを保存します。ファイル名の形式：

[archive_dir]/YYYY-MM-DD-[短い説明]-retro.md

例：H:\My Drive\Retros\2026-05-15-doc-build-retro.md

説明は短く（3〜5語、ハイフン区切り）: dashboard-build、content-draft、data-analysis-q2。

スナップショットテンプレート

# レトロスナップショット：[セッション説明]
**日付：** YYYY-MM-DD
**セッションタイプ：** [SOW作成 / データ分析 / コンテンツ / コード / その他]
**使用されたスキル：** [カンマ区切りリスト]
**レトロ形式：** [WWW / Start-Stop-Continue / 4Ls / など]

---

## ✅ うまくいったこと
- [項目]

## ❌ うまくいかなかったこと
- [項目]

## 🔧 話し合われた変更案
- [項目]

---

## アクションアイテムと結果

| # | 変更内容 | タイプ | 対象 | ステータス |
|---|---|---|---|---|
| 1 | [説明] | スキル更新 | [スキル] v1.0 → v1.1 | ✅ 適用済み |
| 2 | [説明] | プロジェクト/セッション更新 | [プロジェクトCLAUDE.md / クライアントブリーフ / セッション設定] | ✅ 適用済み |
| 3 | [説明] | Claude.md更新 | Claude.md | ✅ 適用済み |
| 4 | [説明] | プロセスノート | — | 📝 記録済み |
| 5 | [説明] | 新しいスキル | [名前] | 🔜 バックログ |

---

## プロセス合意事項
[このレトロ中に行われた行動に関する合意事項 — 次回は別の方法で行うことに両者が合意したことで、ファイル変更にマッピングされないもの]

## 未解決質問 / バックログ
[後で対応するためにメモされた項目、再検討すべきこと、このレトロからのフォローアップ]

## 備考
[保存しておく価値のある追加のコンテキスト]

ステップ2：監査ログの更新

スナップショットを保存した後、アーカイブディレクトリの retro-log.md に1行を追加します。このファイルは実行中のフィードであり — これまでに実行されたすべてのレトロの一目でわかる記録です。

retro-log.md の形式（初回実行時にこのヘッダーで作成）：

# レトロログ

レトロボットセッションの実行記録。

| 日付 | セッション | 適用済み | 記録済み | バックログ | スナップショット |
|---|---|---|---|---|---|

新しい各レトロを1行として追加します。

| 2026-05-15 | ドキュメント作成 – 長文プロポーザル | 2 | 1 | 0 | [link](2026-05-15-proposal-doc-retro.md) |

適用済み：ステータスが ✅ 適用済みのアクションアイテムの数
記録済み：プロセスノートの数（📝 記録済み）
バックログ：🔜 バックログとマークされたアイテムの数

両方のファイルを保存した後、確認します。

「レトロスナップショットを [archive_dir]/[filename] に保存し、監査ログを更新しました。これで記録されたレトロは [N] 件です。」

トーンと精神

Claudeが先に話す — ユーザーの意見を聞く前に、自分の所見を共有します。
具体的に — 「.docx テーブルが、列幅がハードコードされていたためにレンダリングされなかった」は「ファイル形式が間違っていた」よりも有用です。
小さな変更が積み重なる — セッションあたり10分を節約する3行の修正は、すぐに積み上がります。
すべてを修正する必要はない — 適切に選ばれた2つの変更は、中途半端な8つの変更よりも優れています。
迅速に — 10〜15分を目標にします。長引いている場合は、レトロ内で問題を特定するのではなく解決しようとしています。解決はフェーズ6に取っておきます。

リファレンスファイル

references/retro-formats.md — 代替フォーマット：4Ls、Start/Stop/Continue、Mad/Sad/Glad、セイルボート。ユーザーが異なるフォーマットをリクエストした場合、またはデフォルトのWWWよりもバラエティがセッションに適している場合に参照します。
references/action-item-types.md — スキル更新 vs. Claude.md更新 vs. プロセスノート vs. 新しいスキルに関する詳細なガイダンス。アクションアイテムのタイプが曖昧な場合に参照します。

チェンジログ

バージョン	日付	変更内容
v1.0	2026-05-26	初版 — 完全なレトロワークフロー、6フェーズ構造、コピー優先バージョニング、レトロレポートテンプレート
v1.1	2026-05-26	フェーズ0 アーカイブディレクトリ設定（Claude.mdに保存される一度きりの設定）、必須のレトロスナップショット保存、実行中の監査ログ（retro-log.md）とレトロごとの結果追跡を追加
v1.2	2026-05-26	プロジェクト/セッション更新を独立したアクションアイテムタイプとして追加 — プロジェクトCLAUDE.md、Coworkセッション設定、クライアントブリーフファイル、Claude.aiカスタム指示をカバー、ユーザーレベルのClaude.mdとのスコープの違いを明確化
v1.3	2026-05-29	プラグイン構造（skills/retro-bot/SKILL.md）に移行、Claude Code互換性のために .claude-plugin/plugin.json を追加

レトロボット（振り返りボット）