no-polling-agents

バックグラウンドエージェントのポーリングは禁止

並列のバックグラウンドエージェントを起動するときは、sleep ループでポーリングしないでください。

パターン

バックグラウンドエージェントは、完了時にステータスファイルへ書き込みます。自然に完了するのを待ちましょう。

すること

• run_in_background: true を指定してエージェントを起動する
• エージェントの実行中は、ほかの作業を続ける
• ユーザーから依頼されたとき、または作業を進めるために結果が必要なときだけ、ステータスファイルを確認する
• エージェントの完了通知システムを信頼する

しないこと

• sleep 10 && cat status.txt をループで実行する
• 完了を継続的にポーリングする
• ステータスを何度も確認してトークンを無駄にする
• 絶対に必要な場合を除き、エージェントの完了を待って作業を止める

ステータスを確認するタイミング

1. ユーザーから「完了しましたか？」と明示的に尋ねられたとき
2. 次の作業に進むために、エージェントの出力が必要なとき
3. かなり時間が経過し、ユーザーが待っているとき

例

// Launch agents
Task({ ..., run_in_background: true })
Task({ ..., run_in_background: true })

// Continue with other work or conversation
// Agents will write to status file when done

// Only check when needed
cat .claude/cache/status.txt

出典

ユーザーからのフィードバック：「全員から通知が来るまで、そのまま待てばいいだけです」