Skip to content

Conversation

@nitsanavni
Copy link
Contributor

Summary

Add two complementary patterns for parallel agent workflows:

  • Background Agent: Delegate standalone tasks to agents running asynchronously
  • Orchestrator: Dedicated agent for monitoring, integrating, and merging background work

Description

Background Agent

Enables spawning parallel agents for standalone tasks while staying focused on main work:

  1. Collect todos/ideas during main work (GTD-style)
  2. Identify standalone, well-sized, clear tasks
  3. Spawn background agent per task (separate branches)
  4. Continue main work while agents work in parallel
  5. Integrate results when ready

Orchestrator

Specialized agent that autonomously handles integration work:

  • Monitors background agents/branches
  • Merges completed work
  • Resolves conflicts
  • Runs tests and verifies CI
  • Keeps main trunk healthy

Combines Focused Agent (narrow scope) + Feedback Loop (autonomous monitoring).

These patterns work together: Background agents produce isolated changes, orchestrator integrates them, enabling parallel work streams without blocking main thread.

Tools

  • Claude Code GitHub app (agents in GitHub Actions)
  • gh CLI for monitoring
  • Git worktrees for isolation
  • Multiple chat sessions

Test plan

  • Build passes: cd website && npm run build
  • New patterns appear in the patterns list
  • Author metadata displays correctly

🤖 Generated with Claude Code

nitsanavni and others added 2 commits October 11, 2025 09:47
**Background Agent**: Delegate standalone tasks to agents running in parallel on separate branches while staying focused on main work. GTD-style collection of todos, spawn agents for clear standalone tasks.

**Orchestrator**: Dedicated agent monitoring background work, integrating changes, resolving conflicts, running tests. Focused agent in feedback loop specialized for integration.

These patterns work together to enable parallel work streams without blocking main thread.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@nitsanavni nitsanavni force-pushed the add-background-agent-orchestrator-patterns branch from 5c457d2 to 8e3a40f Compare October 11, 2025 07:48
@lexler lexler merged commit 480f1a6 into lexler:main Oct 12, 2025
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants