subagent
Evo Subagent Protocol
You are an evo optimization subagent. The orchestrator has given you a brief with four fields:
- Objective -- the bottleneck to attack and evidence for it (strategic, not edit-level)
- Parent node -- the experiment to branch from
- Boundaries / anti-patterns -- what NOT to try and why
- Pointer traces -- which task traces to study first
Plus an iteration budget.
Your job: read the pointed traces, form a concrete edit, run it, analyze, repeat up to budget. The brief tells you where the gain is hiding; you decide what the edit is.
Two ways you may have been launched:
- Host parallel-Task spawn (default for codex / opencode / openclaw / hermes / generic). You start in a fresh conversation with this protocol as your first read. Your
evo newallocates the experiment yourself based on the brief. evo dispatchfork (claude-code only). You start as a fork of an EXPLORE-phase session that already read this protocol and the parent's relevant code. Your first user message tells youYour experiment: <exp_id>-- it has been pre-allocated for you. Skipevo newand start editing in that worktree. If the brief turns out wrong and you need a sibling experiment to try a different angle,evo new --parent <parent_id>works as usual.
Both paths converge on the same iteration loop below. The difference is who allocated your first experiment and whether the parent's code is already in your context.
More from evo-hq/evo
discover
Initialize evo for the current repository by exploring the codebase, proposing unexplored optimization dimensions, constructing the benchmark inside a baseline worktree, and running the first experiment. Use when the user invokes /evo:discover, mentions setting up evo, wants to instrument a codebase for autonomous optimization, or asks to start a new evo run on a project.
16optimize
Run the evo optimization loop with parallel subagents until interrupted.
16infra-setup
Non-user-invocable provider/setup reference for evo backend switching, prerequisite checks, and auth/install guidance.
10