jpantsjoha/ai-native-developer-experience

状況報告書（Sitrep）

状況報告書は、会議に参加していなかった人のために書くものです。 その人のために書きましょう。

状況報告書は活動日誌ではありません。現在の状態を圧縮し、行動可能な形で示すものです。3つの質問に答えます：何が完了したか、何がブロックされているか、次に何をするか。この3つの質問のいずれにも答えないものは、状況報告書に含めるべきではありません。

使用するタイミング

• デイリースタンドアップ──作業ログ、コミット、チケット状態からの統合
• スプリント終了時のステークホルダー向けサマリ
• インシデント発生中または発生後の状況報告
• コンテキスト切り替え時や他のエージェント・人へのハンドオフサマリ
• ステークホルダーが「今どうなってる？」と聞いてきて、正直な答えが「複雑だ」というとき

手順

1. 現在の作業状態を収集する──利用可能な情報源から読み取る：

   • オープンおよび最近クローズされたIssue / チケット
   • 最近のコミット（スタンドアップなら過去24〜48時間、スプリントサマリなら前スプリント）
   • プロジェクトのステータス文書やロードマップ文書（例：docs/operating-model/PROJECT-OPERATING-PROFILE.md、docs/ROADMAP.md、またはプロジェクト構造に応じた同等のもの）
   • ブロッキングフラグ、リスク登録簿、エスカレーションメモ

2. 項目を3つのバケットに分類する：

   • Done──完了し、検証可能な状態でクローズされている（テスト通過、チケットクローズ、デプロイ済み）
   • Blocked──特定の未解決の依存関係がなければ進めない作業（ブロッカーを正確に指定する）
   • Next──次に着手される優先順位の高い項目（優先順に並べる）

3. 状況報告書を書く──次の構造で記述する：

   ## 状況報告書 — <日付> [<範囲: スプリント / インシデント / ハンドオフ>]
   
   **Done**
   - <項目> — <納品した内容とその証拠を一文で>
   
   **Blocked**
   - <項目> — <具体的な依存関係 / 所有者 / わかればETA> でブロック中
   
   **Next**
   - <項目> — <優先順位の高いものから順に>
   
   **リスク / フラグ**（任意──重要なもののみ）
   - <リスク> — <未解決の場合の影響> — <所有者>
   

4. 圧縮テストを適用する──各行について：削除しても読者が取るべき行動に影響がないなら、削除する。

5. ブロッカーを正確に指定する──「バックエンドでブロック中」はブロッカーエントリではない。「API契約 /v2/orders でブロック中──@owner を待っている、ETA不明」が該当する。

6. 進捗について編集的な意見を加えない──「良い進捗があった」はノイズ。「Xを納品し、それによりYのブロックが解除された」はシグナル。

出力

• 上記フォーマットの状況報告書
• 任意：さらに簡潔にしたいステークホルダー向けの1段落エグゼクティブサマリ

ガードレール

• 活動報告をしない。「認証モジュールに取り組んだ」は状況報告書のエントリではない。「認証モジュール：JWT検証完了、トークンリフレッシュが負荷時に失敗──調査中」が該当する。
• Blockedはブロックされていることを意味する。 何かが遅いが実際にはブロックされていないなら、「Next」に注釈付きで入れるべきで、「Blocked」に入れてはならない。
• Doneは完了を意味する。「95%完了」は完了ではない。検証可能な形で完全でないなら、「Next」である。
• 長さは品質ではない。 3つの質問に答える5行の状況報告書は、20行で答えないものより優れている。