Package Exports
- opencode-orchestrator
Readme
OpenCode Orchestrator
Next-Gen Autonomous Mastery: Powered by HPFAβ’ & MSVPβ’
Redefining Scalability with Fractal Swarm Intelligence and Multi-Stage Integrity
π The End of Sequential Limits. The Era of Fractal Mastery.
Where traditional agents hit a sequential wall, we deploy a fractal swarm. OpenCode Orchestrator is the world's most advanced autonomous engineering platformβa Titan-Class Execution Engine designed to conquer missions that break conventional AI.
By fusing Fractal Swarm Intelligence (HPFAβ’) with Continuous Multi-Stage Verification Pipeline (MSVPβ’), it delivers a level of scale, velocity, and architectural absolute previously considered impossible. Welcome to the final form of autonomous development. No bottlenecks. No limits. Only pure execution.
β‘ Quick Start
npm install -g opencode-orchestratorThen in OpenCode, launch your mission:
/extreme-mission "Architect and Build a Diablo-like Web Engine"π The Four Pillars of Excellence
Weβve combined industrial-grade reliability with cutting-edge parallel intelligence to redefine whatβs possible in AI coding.
- β‘ Velocity: Parallelize up to 50 concurrent sessions. What takes hours for others is finished in minutes through Cognitive Elasticity.
- 𧬠Scale: Fractal Delegation allows workers to recursively spawn their own sub-agents. No task is too big for a system that can replicate its own intelligence.
- π‘οΈ Safety: Our MSVP (Multi-Stage Verification Pipeline) reviews every line of code in parallel "Shadow Sessions" before it ever touches your build.
- βΎοΈ Trust: Iron-Clad Reliability via Write-Ahead Logging (WAL). Even after a crash, the system replays its history to resume exactly where it was.
β Core Philosophy
βββββββββββββββββββββββββββββββββββββββββββββββββββββ
β π EXPLORE β π LEARN β π ADAPT β β‘ ACT β
β Scan Document Adjust Execute β
βββββββββββββββββββββββββββββββββββββββββββββββββββββπ The Agents
| Agent | Role | What It Does |
|---|---|---|
| π― Commander | Orchestrator | Leads the task, delegates work to other agents, ensures completion |
| π Planner | Researcher | Analyzes the project, creates the plan, documents findings |
| π¨ Worker | Implementer | Writes code, modifies files, follows the project's patterns |
| β Reviewer | Verifier | Tests changes, checks for errors, confirms quality |
π Principles
| Principle | What It Means |
|---|---|
| π Never Assume | Always check the actual code and config files first |
| π Document Everything | Record patterns and findings for future tasks |
| π Verify with Evidence | Run tests, cite sources, complete with proof |
| π Adapt to the Project | Match the project's existing style and patterns |
| π€ Specialized Roles | Each agent has a clear, focused responsibility |
ποΈ Hyper-Parallel Architecture: HPFA & MSVP
The orchestrator eliminates the linear bottleneck of AI development through two breakthrough technologies:
𧬠HPFA (Hyper-Parallel Fractal Architecture)
Imagine an agent that doesn't just work, but thinks like a Hive Mind.
- Fractal Delegation: Workers are no longer just "doers." They are mini-planners that can recursively spawn their own sub-agents to handle complexity at every level.
- Speculative Racing: Ambiguous tasks are solved using multiple strategies in parallel. The fastest, most accurate path wins, while others are prunedβminimizing latency and maximizing quality.
π‘οΈ MSVP (Multi-Stage Verification Pipeline)
Speed is nothing without accuracy. MSVP ensures your code is production-ready at every second.
- Shadow Parallel Review: As soon as a file is written, a parallel reviewer session is already validating it before the main task even finishes.
- Barrier-Sync Integration: A 4-stage verification gate that prevents "architectural drift" by forcing a global synchronization barrier before final sealing.
/extreme-mission "Build Complex System"
β
βββββββββββββββββββββββββββββββββββββββββ
β π― COMMANDER β Orchestrator β
β (Main Session - Single) β
βββββββββββββββββββββ€ββββββββββββββββββββ
β
βββββββββββββββββββββΌββββββββββββββββββββ
β π PLANNER β Create Plan β
β β Outputs: Architectural Grid β
βββββββββββββββββββββ¬ββββββββββββββββββββ
β
βββββββββββββββββββββββββββ§ββββββββββββββββββββββββββ
β π₯ HPFA PARALLEL GRID (MSVP) β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β β β β
βΌ βΌ βΌ βΌ
ββββββββββββ ββββββββββββ ββββββββββββ ββββββββββββ
βπ¨ WORKER β βπ¨ WORKER β βπ¨ WORKER β βπ¨ WORKER β <-- Fractal Spawning
β Module A β β Module B β β Module C β β Module D β
ββββββ¬ββββββ ββββββ¬ββββββ ββββββ¬ββββββ ββββββ¬ββββββ
β β‘ Instant β β‘ Instant β β‘ Instant β β‘ Instant
βΌ Review βΌ Review βΌ Review βΌ Review
ββββββββββββ ββββββββββββ ββββββββββββ ββββββββββββ
ββ
REVIEWRβ ββ
REVIEWRβ ββ
REVIEWRβ ββ
REVIEWRβ <-- Stage 1: Unit
β (Unit-A) β β (Unit-B) β β (Unit-C) β β (Unit-D) β Verification
ββββββ¬ββββββ ββββββ¬ββββββ ββββββ¬ββββββ ββββββ¬ββββββ
β β β β
ββΌββββββββββββββββΌββββββββββββββββΌββββββββββββββββΌββββ
β β³ SYNC BARRIER β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β
βββββββββββββββββββββΌββββββββββββββββββββ
β β
MASTER REVIEWER β Final Pass β
β (Cross-module Integration) β
β β Stage 2: E2E & System Integrity β
βββββββββββββββββββββ¬ββββββββββββββββββββ
β
βββββββββββ΄ββββββββββ
β Seal Conditions β
β Verified? β
βββββββββββ¬ββββββββββ
No β β Yes
β»οΈ LOOP ποΈ MISSION
(Adaptive) SEALEDExecution Model (MSVP)
| Phase | Agent | Parallelism | Verification Level |
|---|---|---|---|
| 1οΈβ£ Plan | Planner | Single | Static Analysis |
| 2οΈβ£ Implement | Workers | HPFA Parallel | Direct Coding |
| 3οΈβ£ Unit Pass | Reviewers | Shadow Parallel | 1μ°¨ 리뷰: Unit Tests (Async) |
| 4οΈβ£ Final Sync | Barrier | Blocking | All Units Verified |
| 5οΈβ£ Integration | Master Reviewer | Single | 2μ°¨ 리뷰: Full E2E & Sync |
Features
| Feature | What It Does |
|---|---|
| π MSVP Pipeline | Parallel unit reviews triggered immediately after worker tasks |
| 𧬠Fractal Spawning | Workers can recursively spawn sub-missions for complex tasks |
| β‘ 20+ Parallel Tasks | High-intensity execution with safety concurrency limits |
| π Non-Stop Recovery | WAL-based persistence (resumes tasks after crashes) |
| π₯ Multi-File Ops | Work on different files at the same time |
| π‘οΈ Self-Scaling | Dynamic concurrency limits based on success/failure |
| π©Ή Memory Integrity | Strict resource cleanup prevents leaks in long sessions |
| ποΈ Architectural Modularity | Enforces language-agnostic clean code principles |
Error Handling
| Error | What Happens |
|---|---|
| π₯ Tool crash | Inject recovery prompt and retry |
| π¦ Rate limit hit | Wait and retry with exponential backoff |
| π¦ Context overflow | Compact the context automatically |
| β±οΈ Session timeout | Resume from the last checkpoint |
| π¨ Build failure | Fix the issue and retry |
πΉ Developer's Words
"We are not just building a tool; we are building an autonomous engineer that can evolve with the project. HPFA and MSVP are the heart of this evolutionβturning AI from a chatbot into a high-performance execution engine."
π License
MIT License. LICENSE