codeaholicguy/ai-devkit

agent-orchestration

AI DevKit · Supervise multi-agent workflows over repeated passes: poll progress, unblock waiting agents, coordinate dependencies, relay outputs, resolve conflicts, and verify completion.

Vedi sorgente

Come usare

  1. Copia il comando e controlla il pacchetto prima di installarlo nel tuo ambiente agente.
  2. Controlla strumenti, credenziali e ambienti richiesti nel documento originale.
  3. Descrivi input e risultato desiderato; confronta l’output con le fonti.
npx skills add https://github.com/codeaholicguy/ai-devkit --skill agent-orchestration

Prima di iniziare

  • L’installazione non include abbonamenti, quote API o accesso ai file.
  • Stelle e installazioni indicano attività, non un test indipendente di qualità o sicurezza.
Documento Skill originale

Contenuto dal repository con titoli, esempi, codice, tabelle, link e immagini preservati.

Agent Orchestration

Use only for multi-agent supervision: coordinating dependencies, polling progress, unblocking waiting agents, relaying outputs, resolving conflicts, and verifying completion across agents. For one-off list/detail/send/start/kill work, use agent-management or agent-communication.

Use agent-management for safe agent selection and lifecycle actions. Use agent-communication for list/detail/send mechanics. Use verify before accepting any agent's completion claim.

Rules

  • Own the loop until assigned work is complete, blocked, or stopped.
  • Run agent list --json before each pass; never assume names/statuses.
  • Inspect waiting, idle, unknown, missing, or stale agents before acting.
  • Send self-contained instructions and avoid duplicate follow-ups.
  • Sequence agents that touch the same files; relay only relevant upstream output.
  • Escalate only for repeated failures, unresolved conflicts, product/business decisions, or destructive/shared/production/security-sensitive actions.

Loop

If the goal or agent ownership is unclear, run one scan/detail pass. Ask the user once only if context is still insufficient.

  1. Scan agents.
  2. Assess agents needing attention with detail --tail 10.
  3. Act: approve, clarify, correct, delegate, relay, verify, or escalate.
  4. Report one brief status line.
  5. Sleep 15 minutes and repeat. Meaningful agent progress arrives in minutes-to-tens-of-minutes; faster polling adds noise and orchestrator token cost without signal. Exception: if an agent is known to be waiting on you (approval prompt, ASK/BLOCKED just fired), check back sooner.

Completion

Finish when all assigned work is verified, blocked with a clear reason, or stopped by the user. Summarize per-agent outcomes, verification, unresolved issues, and next step.