Flow Attention Refresh - 注意力刷新プロトコル

概要

「真ん中で迷子になる」効果を解決します。コンテキストが長すぎると、元の目標が注意のウィンドウから「押し出され」てしまう現象です。

問題:
コンテキスト開始: [元の目標 - 距離が遠く、「忘れ去られる」]
     ↓
... 50+ 工具呼び出し ...
     ↓
コンテキスト末尾: [最近の工具出力 - 注意のウィンドウ内]

解決:
重要な瞬間に目標ドキュメントを強制的に読み込む → 目標を注意のウィンドウに「引き戻す」

鉄の掟

重大な決定の前 → GOAL ファイルを読む → その後、行動する

Refresh プロトコル

プロトコル 1: Flow Entry (各 flow-* コマンド開始時)

トリガー: 任意の /flow-* コマンドの Entry Gate

アクション:

read:
  - BRAINSTORM.md "成功基準" 節
  - TASKS.md 現在の段階のタスクリスト
focus: 今回のコマンドで何を達成したいか？

実装: 既存の Brainstorm Alignment Check でカバー済み

プロトコル 2: Task Start (flow-dev 各タスク開始時)

トリガー: flow-dev TDD ループにおいて、各タスク実行前

アクション:

read:
  - TASKS.md 現在のタスク T### 段落 + DoD
  - quickstart.md 関連コマンド
focus: このタスクの受け入れ基準は何か？

実装場所: flow-dev.md 段階 3 TDD ループ

コードスニペット:

**注意力刷新** (プロトコル 2):
→ Read: TASKS.md 現在のタスク T### 段落
→ Focus: タスク目標と DoD
→ Then: タスクの実行を開始

プロトコル 3: Ralph Iteration (Ralph ループの各イテレーション)

トリガー: /flow-ralph の各イテレーション開始時

アクション:

read:
  - TASKS.md 最初の未完了タスク
  - ERROR_LOG.md 最近 5 件の記録
focus: 次の行動 + 繰り返しのエラーを避ける

実装場所: flow-ralph.md Ralph Loop の開始箇所

コードスニペット:

**注意力刷新** (プロトコル 3):
→ Read: TASKS.md 最初の `- [ ]` タスクを見つける
→ Read: ERROR_LOG.md 最近 5 件 (存在する場合)
→ Focus: 次の行動は何か？ 避けるべきエラーは何か？
→ Then: タスクを実行

プロトコル 4: Error Recovery (エラー発生後)

トリガー: テスト失敗、ビルドエラー、ランタイム例外発生後

アクション:

read:
  - ERROR_LOG.md 現在のエラー記録
  - TASKS.md 現在のタスク定義
focus: エラーの根本原因 + 解決策

実装場所: flow-tdd skill のエラー処理部分

コードスニペット:

**エラー回復刷新** (プロトコル 4):
→ Record: エラーを ERROR_LOG.md に追加
→ Read: ERROR_LOG.md 現在のエラー + 過去の類似エラー
→ Read: TASKS.md 現在のタスク
→ Focus: 根本原因の分析、盲目的な修正を避ける
→ Then: ターゲットを絞った修正

Integration Map

既存のメカニズム:
┌──────────────────────────────────────┐
│ flow-brainstorming skill             │
│ ↓ /flow-init でトリガー              │
│ ↓ BRAINSTORM.md を出力                 │
└──────────────────────────────────────┘
              ↓
┌──────────────────────────────────────┐
│ Brainstorm Alignment Check           │
│ ↓ 各 flow-* Entry Gate で実行           │
│ ↓ BRAINSTORM.md を読み込み、整合性を検証        │
│ ↓ = プロトコル 1                       │
└──────────────────────────────────────┘

新規メカニズム:
┌──────────────────────────────────────┐
│ flow-attention-refresh skill (本ファイル) │
│ ↓ flow-dev, flow-ralph から参照       │
│ ↓ より細かい粒度で注意力を刷新          │
│ ↓ プロトコル 2, 3, 4                   │
└──────────────────────────────────────┘

Rationalization Prevention

Red Flags - STOP

もしあなたが以下のような状態に気づいたら：

• タスクを開始する前に TASKS.md を読んでいない
• エラーが発生した後、まず ERROR_LOG.md に記録していない
• Ralph ループで前回の誤りを読み込むのを忘れた
• 意思決定時に BRAINSTORM.md を参照していない

STOP。対応するプロトコルを実行してください。

[PROTOCOL]: 変更時はこのヘッダーを更新し、その後 CLAUDE.md を確認してください