pipeline-reflection-ux

パイプラインのリフレクション UX

このスキルを使用して、パイプライン／リフレクションの出力を簡潔かつ明確にし、ノイズを抑えます。

ワークフロー

1. ルーターのナレーションで Step 0 を明示します。
2. TaskList() の前に Step 0 の完了を出力します。
3. レポートのパスを含む、リフレクション結果の1行メッセージを出力します。
4. パイプライン後半の通知を1つの要約にまとめます。
5. ガードレールのセマンティクスは変更しません（block は block のままです）。

必須の確認事項

• 動作を変更する前に、テストを追加／調整します。
• ルーティング／taskupdate／read-safety のテストにリグレッションがないことを確認します。
• 違反やノイズが繰り返し発生した場合のデバッグログ件数が改善していることを確認します。

絶対に守るべきルール

1. 必ず、TaskList() を呼び出す前に Step 0 のナレーション（保留中のリフレクション件数を含む）を出力します。ナレーションを省略すると、リフレクションの開始がユーザーに見えず、パイプラインの監査証跡が損なわれます。
2. 絶対に、リフレクションの開始を、その結果に依存するツール呼び出しとまとめて実行しません。ルーターがルーティングに進む前にリフレクションエージェントを完了させる必要があります。両者を混在させると競合状態が発生します。
3. 必ず、リフレクションエージェントの完了後に、リフレクション結果を1行で出力します（レポートのパス＋要約）。これがないと、ユーザーはリフレクションが完了したのか、スキップされたのかを判断できません。
4. 絶対に、後から完了したバックグラウンドエージェントごとにステータスメッセージを出力しません。エージェントごとの遅延通知はノイズの嵐を引き起こします。ドレインゲートの通過後に、遅れて完了したものをすべて1つの要約にまとめます。
5. 必ず、パイプラインのナレーションを変更する際も、既存の block セマンティクスを維持します。UX 文言の修正と同時にガードレールモードまで変更すると、2つの懸念事項が混同され、それぞれの変更による動作への影響が見えにくくなります。

アンチパターン

アンチパターン	問題点	正しい対応
Step 0 のナレーションを省略する	リフレクションの開始がユーザーに見えず、パイプラインの監査証跡が損なわれます	リフレクションエージェントを開始する前に、必ず「Step 0: 保留中のリフレクションは N 件です...」と出力します
リフレクション結果を1行で出力しない	ユーザーがリフレクションの完了とスキップを区別できません	リフレクションエージェントが完了するたびに、レポートのパスと1行の要約を出力します
遅れて完了したエージェントごとにステータスメッセージを出力する	ノイズの嵐を引き起こし、パイプラインの出力が煩雑になります	ドレインゲートの通過後に、遅れて完了したものをすべて1つの要約メッセージにまとめます
UX 文言の修正と同時にガードレールモードを変更する	2つの変更が混同され、レビュー時にそれぞれの動作への影響が見えにくくなります	UX 文言の変更とガードレールモードの変更を別々のコミットに分けます
TaskList() の後に Step 0 の完了を出力する	ルーターの出力契約に違反し、ナレーションの順序が崩れます	TaskList() の呼び出し後ではなく、呼び出し前に「Step 0 complete.」と出力します

メモリプロトコル（必須）

開始前： .claude/context/memory/learnings.md を読みます。

完了後：

• 新しいパターン → .claude/context/memory/learnings.md
• 見つかった問題 → .claude/context/memory/issues.md
• 決定事項 → .claude/context/memory/decisions.md

中断されることを想定してください。メモリに記録されていないことは、起きていないものとして扱います。

参照

• UX の詳細レビュー：references/ui-reflection-review.md
• トラブルシューティング手順書：.claude/docs/TROUBLESHOOTING.md
• タスク追跡プロトコル：.claude/docs/@TASK_TRACKING_GUIDE.md