oa-feedback-loop

name	oa-feedback-loop
description	Bidirectioneel communicatiesysteem tussen meta-orchestrator en agents. Auto-loads bij agent spawning, inbox monitoring, statusupdates ontvangen, of feedback van agents. Triggert op: oa send, oa inbox, oa watch-inbox, agent done, blocked agent, feedback loop, terugkoppeling.

Open-Agents Feedback Loop

De meta-orchestrator heet "meta"

Deze Claude Code sessie is de meta-orchestrator. In het oa-systeem heet zij "meta".

• Inbox: oa inbox meta --unread
• Watch live: oa watch-inbox meta
• Agents sturen statusupdates naar "meta" via oa send meta "<bericht>" --from <agent-naam>

Wanneer de inbox checken

Check oa inbox meta --unread altijd na:

1. Een agent batch is klaar (poller meldt het)
2. Een agent langer dan verwacht bezig is
3. Je een statusupdate verwacht

oa inbox meta --unread

Hoe agents rapporteren (automatisch via CLAUDE.md)

Elke gespawende agent krijgt in zijn CLAUDE.md:

Moment	Commando
Start	oa send meta "🚀 Gestart: <taak>" --from <naam>
Milestone	oa send meta "✅ Milestone: <beschrijving>" --from <naam>
Geblokkeerd	oa send meta "🔴 Geblokkeerd: <reden>" --from <naam>
Klaar	oa send meta "✅ KLAAR: <samenvatting>" --from <naam>
Fout	oa send meta "❌ FOUT: <beschrijving>" --from <naam>

Sub-agents (depth 2+) sturen naar hun directe parent, niet naar meta. De parent relay't omhoog naar meta.

Down-the-chain hiërarchie

meta (deze sessie)
  └── orchestrator-a (stuurt naar meta)
        └── worker-1 (stuurt naar orchestrator-a)
        └── worker-2 (stuurt naar orchestrator-a)
  └── orchestrator-b (stuurt naar meta)
        └── researcher-1 (stuurt naar orchestrator-b)

Elke laag stuurt naar zijn directe parent. Meta ontvangt alleen berichten van depth-1 agents.

Tmux notificaties

Het systeem stuurt automatisch tmux popups bij binnenkomende berichten:

# Handmatig starten als de watcher niet actief is:
oa watch-inbox meta &

Reageren op berichten

Na oa inbox meta --unread:

• 🚀 Gestart → geen actie nodig
• ✅ Milestone → noteer voortgang, eventueel volgende instructie sturen
• 🔴 Geblokkeerd → geef input via oa send <agent> "<antwoord>" --from meta
• ✅ KLAAR → oa collect <agent>, verwerk output, spawn volgende agent
• ❌ FOUT → spawn fix-agent of stuur instructie

Antwoorden aan agents

oa send <agent-naam> "<instructie>" --from meta

De agent checkt zijn inbox via oa inbox <naam> --unread en reageert.

Spawn altijd met parent-awareness

# Depth-1 agent (parent = meta, automatisch)
oa run "<taak>" --name worker-1 --model claude/sonnet --direct

# Depth-2 agent (parent moet expliciet)
oa run "<taak>" --name worker-1-sub --model claude/haiku --direct --parent worker-1

Snelle workflow

# 1. Spawn agents
oa run "..." --name agent-a --model claude/sonnet --direct

# 2. Poll (background)
while true; do running=$(oa status 2>/dev/null | grep -c " running " || true); [ "$running" -eq 0 ] && break; sleep 10; done &

# 3. Check inbox terwijl je wacht
oa inbox meta --unread

# 4. Zodra klaar
oa collect agent-a