| title | Drover Orchestrator documentation | ||
|---|---|---|---|
| description | Diátaxis index for self-hosted parallel agent orchestration with DBOS durable workflows. | ||
| product | drover-orchestrator | ||
| audience |
|
||
| doc_type | explanation | ||
| topics |
|
||
| surface | repo-docs |
Documentation follows Diátaxis: four types of content for four different needs.
Drover Orchestrator runs on your machine or CI — parallel coding agents in Git worktrees with DBOS crash recovery. It is not the hosted agent job API in Drover Cloud (Milestone A). See Cloud boundary.
| Need | Type | Start here |
|---|---|---|
| Learn by doing | Tutorial | First parallel epic · Resume after crash |
| Accomplish a task | How-to | How-to guides |
| Look up facts | Reference | CLI reference · Configuration · Feature specs |
| Understand concepts | Explanation | Architecture overview |
Step-by-step lessons for newcomers.
- First parallel epic —
drover init→ epic → blocked tasks →drover run - Resume after crash — interrupt and recover with DBOS checkpoints
Goal-oriented recipes.
- Configure agents — Claude, Codex, Amp, OpenCode, worker subprocess isolation
- Planning vs building mode — plan review before implementation
- Set up PostgreSQL for production —
DBOS_SYSTEM_DATABASE_URL - Route LLM traffic through Gateway — agent CLI env + local Gateway
Background, design rationale, and mental models.
- Architecture overview
- Design document
- Sequence diagrams
- State machine
- Enhancement proposals
- RoboRev enhancements
- Worktree prewarming dashboard
- Cloud boundary — orchestrator vs hosted agent jobs
Not part of the public Diátaxis quadrants:
- Project overview — install, quick start, command cheat sheet
- Domain glossary
- Org backlog
New pages under docs/ require YAML frontmatter per the org content taxonomy; validate with scripts/validate-content-frontmatter.sh.