No Polling Agents

by parcadeid07ff4b06b62No license3.9K starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 8 months ago

No Polling for Background Agents

Instructions onlyAI & Agents
AI-generated overview

Guidance for AI agents on waiting for background agents without polling loops.

What it does
This skill is an instruction document that tells an agent how to handle parallel background agents. It advises launching them in the background, continuing other work, and checking a status file only when the user asks or when results are needed. It lists discouraged behaviors such as repeated sleep-and-check loops and blocking on agents.
When to use it
Use it when coordinating multiple background agents that write status files on completion. It applies when an agent is tempted to poll for completion or block unnecessarily. It is not user-invocable and is meant as internal operating guidance.
Requirements
No tools, packages, or credentials are required; it is instructions only and ships no scripts.

No Polling for Background Agents

When launching parallel background agents, do NOT poll with sleep loops.

Pattern

Background agents write to status files when complete. Wait for them naturally.

DO

  • Launch agents with run_in_background: true
  • Continue with other work while agents run
  • Check status file only when user asks or when you need results to proceed
  • Trust the agent completion system

DON'T

  • Run sleep 10 && cat status.txt in loops
  • Continuously poll for completion
  • Waste tokens checking status repeatedly
  • Block on agents unless absolutely necessary

When to Check Status

  1. User explicitly asks "are they done?"
  2. You need agent output to proceed with next task
  3. Significant time has passed and user is waiting

Example

typescript
// Launch agentsTask({ ..., 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 neededcat .claude/cache/status.txt

Source

User feedback: "You can just wait until everyone pings you"

Source and attribution

Source:parcadei/continuous-claude-v3in.claude/skills/no-polling-agentsat commitd07ff4b

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal