iterate-lessons-log

教訓ログ

教訓ログのエントリーには、プロジェクト、インシデント、経験から得た重要な学びを、その場にいなかった将来のチームにも役立つ形式で記録します。チームの改善に焦点を当てる振り返りとは異なり、教訓ログは個々のチームを超えて組織に蓄積される知識、パターン、アンチパターン、そして苦労の末に得られた知見に焦点を当てます。

使用する場合

• 重要なプロジェクトや取り組みが完了した後
• 重大なインシデント、サービス停止、障害が発生した後
• 他の人も知っておくべき重要なことに気づいたとき
• 繰り返し発生するパターンを見つけた後
• 経験豊富なチームメンバーが退職するとき（知識を記録するため）
• 学びを残すための事後検証の際

使用しない場合

• チームのセレモニー自体を進行する場合 -> iterate-retrospective を使用します。このスキルは、セレモニーが終わった後も残る、長期的に役立つエントリーを蓄積します
• 結果に基づいて方針を変更するかどうかを判断する場合 -> iterate-pivot-decision を使用します
• 実験結果の報告である場合 -> まず measure-experiment-results を使用し、その後、他の場面にも応用できる教訓をここに記録します
• 学んだことをステークホルダーに報告する場合 -> foundation-stakeholder-update を使用します

手順

教訓ログのエントリーを作成するよう依頼された場合は、次の手順に従います。

1. 内容が伝わるタイトルを付ける このトピックを検索する人が見つけやすいタイトルを書きます。状況と学びを表すキーワードを含めます。「プロジェクト X の教訓」のような一般的なタイトルは避けます。

2. 背景を説明する その場にいなかった人が理解できるよう、状況を十分に説明します。プロジェクト、時期、チーム、関連する制約を含めます。将来の読者がこの教訓を適用できるか判断するには、こうした背景が必要です。

3. 何が起きたかを記述する 起きたことを事実に基づいて説明します。実施した対応、下した判断、確認された結果を具体的に記します。責任の追及は避け、出来事や仕組みに焦点を当てます。

4. 教訓を抽出する 学んだことを明確に述べます。他の人が活用できる、実行可能な教訓にします。観察したことと、それが重要である理由についての解釈を区別します。

5. 推奨事項をまとめる 同様の状況に直面する将来のチームに向けて、具体的な指針を示します。何をすべきか、何を避けるべきか、どのような質問をすべきかを記します。

6. 適用範囲を定める この教訓がどのような場合に当てはまるか、読者が判断できるようにします。どのような状況で関連性が生じるか、どのような背景が適用の度合いに影響するかを記します。

7. 検索しやすいタグを追加する 将来このエントリーを探す人に役立つキーワードやカテゴリを含めます。同様の状況に直面した人が何を検索するかを考えます。

出力形式

出力を構成するには、references/TEMPLATE.md のテンプレートを使用します。完成したエントリーでは、メタデータ、概要、背景、起きたこと、教訓、推奨事項、適用範囲、裏付けとなる証拠、タグとカテゴリ、レビューと更新のすべてのセクションを埋めます。

品質チェックリスト

最終確認の前に、次の点を確認します。

• タイトルが内容をよく表し、検索しやすい
• その場にいなかった人にも十分な背景が伝わる
• 教訓が明確で、実行に移せる
• 推奨事項が具体的で、曖昧でない
• エントリー単体で理解できる（外部の背景情報を必要としない）
• タグによって後から見つけやすくなっている

例

完成例については、references/EXAMPLE.md を参照してください。