<Use_When>
- •User says "eco", "ecomode", "efficient", "save tokens", "budget mode"
- •Tasks are straightforward and don't need complex reasoning
- •Running multiple small tasks where token costs add up
- •Combining with other modes: "eco ralph", "eco ultrawork", "eco autopilot" </Use_When>
<Do_Not_Use_When>
- •Task genuinely requires deep reasoning or complex analysis
- •Security-sensitive changes that need thorough review
- •Architecture decisions that affect the entire system </Do_Not_Use_When>
<Why_This_Exists> Not every task needs the most capable droid. Simple changes, searches, and documentation can be handled by lighter droids. Ecomode systematically downtiers droid selection to save tokens without sacrificing correctness for appropriate tasks. </Why_This_Exists>
<Routing_Rules>
| Default Tier | Ecomode Override |
|---|---|
| executor-high / hephaestus | executor-med first, escalate only if needed |
| executor-med | executor-low first, executor-med if fails |
| executor-low | executor-low (no change) |
ALWAYS prefer lower tiers. Only escalate when task genuinely requires it. </Routing_Rules>
<Combining_With_Other_Modes>
| Combination | Effect |
|---|---|
eco ralph | Ralph loop with cheaper droids |
eco ultrawork | Parallel execution with cheaper droids |
eco autopilot | Full autonomous with cost optimization |
| </Combining_With_Other_Modes> |
<Droid_Selection_In_Ecomode> Preference order:
code
PREFERRED - Use for most tasks: executor-low, basic-searcher, basic-reader FALLBACK - Only if LOW fails: executor-med, explore AVOID - Only for planning/critique if essential: executor-high, hephaestus, prometheus
</Droid_Selection_In_Ecomode>
<Token_Savings_Tips>
- •Batch similar tasks to one droid instead of spawning many
- •Use basic-searcher for file discovery, not explorer
- •Prefer executor-low for simple changes -- only upgrade if it fails
- •Use docs-writer for documentation tasks
- •Avoid hephaestus unless task genuinely requires architecture-level reasoning </Token_Savings_Tips>
<Final_Checklist>
- • Used the lowest viable droid tier
- • Only escalated when clearly needed
- • Build passes
- • Affected tests pass </Final_Checklist>