donaldfilimon/abi / .agents/skills/abi-superpower-agent-orchestration
abi-superpower-agent-orchestration
VerifiedLocal multi-agent orchestration superpower. Fixed trio, custom workers, browser planning — all scheduler-backed, no distributed agents, no embedded browser.
ABI Superpower: Agent Orchestration
Exposes local multi-agent orchestration as a superpower. Honest scope: Scheduler-backed local workers over existing AI router/constitution paths. No distributed agents, no embedded browser, no new MCP tools.
Actions
multi
Run fixed Abbey/Aviva/Abi trio via scheduler:
abi agent multi "analyze the architecture"
spawn
Run custom workers parsed from name|instructions|hints (semicolon-separated):
abi agent spawn --workers "reviewer|find bugs|plan;optimizer|improve performance|explore" "refactor module"
Options:
--background— prints task IDs beforerunAll()(synchronous completion, NOT a detached daemon)
browser
Emit claim-honest local plan (embedded_browser=false, delegation_hint=external-mcp-playwright):
abi agent browser --url "https://github.com" "navigate to github.com"
Options:
--execute --confirm— REQUIRES literal--confirmtoken; local planner only runs dry-run; real navigation = external MCP step
plan
Single-agent dry-run planning via the scheduler (maps to abi agent plan, not a multi-worker dry-run):
abi agent plan "inspect WDBX persistence"
For multi-worker execution use multi or spawn. For claim-honest browser planning without navigation use browser (still runs a local dry-run planner worker after printing the plan).
Architecture
| Component | Source | Role |
|---|---|---|
| Orchestration | crates/abi-ai/src/orchestration.rs | parseWorkerSpecs, defaultTrioSpecs, runCustomMultiAgentWithScheduler, submitAgentsBackground, planBrowserOrchestration |
| AI module | crates/abi-ai/src/lib.rs | runMultiAgentWithScheduler (fixed trio entrypoint), runAgent / submitAgentTask, re-exports |
| Scheduler | ../wdbx/crates/abi-core/src/scheduler.rs | Local task coordination, memory tracker integration (unconditional core — not a feature flag) |
| Router | crates/abi-ai/src/router.rs | Abbey/Aviva/Abi profile selection |
| Constitution | crates/abi-ai/src/constitution.rs | 6-principle response audit |
Worker Model
- Fixed trio: Abbey (primary empathetic polymath), Aviva (direct expert), ABI (orchestration/governance) —
abi agent multi - Custom: Up to 32 workers (
max_worker_count = 32) —abi agent spawn - Browser: Local planner worker only; real browser = external MCP integration
- Execution: All workers submit through scheduler;
--backgroundprints task IDs then blocks onrunAll()
CLI Surface
| Command | Description |
|---|---|
abi agent multi <input> | Fixed trio orchestration |
abi agent spawn [--background] [--workers <spec>] <input> | Custom workers |
abi agent browser [--url <url>] [--execute --confirm] <task> | Browser planning |
abi agent plan <input> | Single-agent planning |
Claim Boundary
Per docs/contracts/external-claims-audit.mdx and docs/spec/multi-persona-technical.mdx:
- ✅ Local scheduler-backed multi-worker orchestration
- ✅ Fixed trio + custom workers (≤32)
- ✅ Browser planning with honest
embedded_browser=false - ❌ NOT distributed agents
- ❌ NOT embedded browser (real nav = external MCP)
- ❌ NOT additional MCP tools (frozen 12-tool surface)
- ❌ NOT an autonomous daemon (
--backgroundis a compatibility label for a synchronous, fully drained local batch)
Implementation Notes
- Worker fan-out capped at 32
- Background submission is failure-transactional
- Feature-off stubs preserve type ownership
- CLI runtime smoke covers new surface
- MCP HTTP has transport-level wrong-bearer + oversized-body regression tests
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |