diff options
| author | Agando <roduccomm@gmail.com> | 2026-06-02 18:00:37 +0200 |
|---|---|---|
| committer | Agando <roduccomm@gmail.com> | 2026-06-02 18:00:37 +0200 |
| commit | aafb0fbde5289a45f9f818a00141f80b149be283 (patch) | |
| tree | d4d8f588187719c99240fbaef1940c068402b892 /skills/agent-orchestration.md | |
| parent | 6d41e590a38c73ef60f1c04beaf8f5438f350f46 (diff) | |
auto: 2026-06-02_18:00 changes
Diffstat (limited to 'skills/agent-orchestration.md')
| -rw-r--r-- | skills/agent-orchestration.md | 35 |
1 files changed, 35 insertions, 0 deletions
diff --git a/skills/agent-orchestration.md b/skills/agent-orchestration.md new file mode 100644 index 0000000..060ec96 --- /dev/null +++ b/skills/agent-orchestration.md @@ -0,0 +1,35 @@ +--- +name: agent-orchestration +description: How to use the agent registry, leases, and orchestrator for multi-agent workflows +tags: [agents, orchestration, delegation, leases] +category: system +--- +## Steps +1. **Agent Registry:** + - agent-list — list all registered agents (ID, type, capabilities, status) + - agent-register <type> <capabilities> — register a new agent (capabilities: comma-separated like "code,research") + - agent-unregister <id> — remove an agent + - agent-status <id> — detailed status including uptime, task history + +2. **Leases (time-bound contracts):** + - lease-create <agent-id> <ttl-seconds> — create a lease with watchdog timer + - lease-list — show active leases with remaining TTL + - lease-revoke <lease-id> — terminate a lease early + - lease-renew <lease-id> <ttl-seconds> — extend a lease + +3. **Orchestrator (spawn, delegate, kill):** + - orchestrator-spawn <type> <capabilities> — spawn a new agent automatically (registers + creates lease) + - orchestrator-kill <agent-id> — kill an agent (revokes lease + unregisters) + - orchestrate — list all active agents with their orchestrator state + - orchestrator-purge — kill all idle/expired agents + - orchestrator-status — full system status: active, idle, dead agents + +4. **AI tool integration:** + - AI tools list_agents, delegate_task, spawn_agent are available in the AI system prompt + - The AI can auto-spawn worker agents for sub-tasks + - Each agent gets its own VFS workspace at /agents/<agent-id>/ + +5. **When to use:** + - User needs parallel task execution → orchestrator-spawn coder + researcher + - Time-bound automation → lease-create with short TTL + - System cleanup → orchestrator-purge to kill stale agents
\ No newline at end of file |