Ecomode Skill
Token-efficient model routing. This is a MODIFIER, not a standalone execution mode.
What Ecomode Does
Overrides default model selection to prefer cheaper tiers:
| Default Tier | Ecomode Override |
|---|---|
| HIGH (opus) | MEDIUM (sonnet), HIGH only if essential |
| MEDIUM (sonnet) | LOW (haiku) first, MEDIUM if fails |
| LOW (haiku) | LOW (haiku) - no change |
What Ecomode Does NOT Do
- Persistence: Use
ralphfor "don't stop until done" - Parallel Execution: Use
ultraworkfor parallel agents - Delegation Enforcement: Always active via core orchestration
Combining Ecomode with Other Modes
Ecomode is a modifier that combines with execution modes:
| Combination | Effect |
|---|---|
eco ralph | Ralph loop with cheaper agents |
eco ultrawork | Parallel execution with cheaper agents |
eco autopilot | Full autonomous with cost optimization |
Ecomode Routing Rules
ALWAYS prefer lower tiers. Only escalate when task genuinely requires it.
| Decision | Rule |
|---|---|
| DEFAULT | Start with LOW tier (Haiku) for most tasks |
| UPGRADE | Escalate to MEDIUM (Sonnet) when LOW tier fails or task requires multi-file reasoning |
| AVOID | HIGH tier (Opus) - only for planning/critique if essential |
Agent Selection in Ecomode
FIRST ACTION: Before delegating any work, read the agent reference file:
Read file: docs/shared/agent-tiers.md
This provides the complete agent tier matrix, MCP tool assignments, and selection guidance.
Ecomode preference order:
// PREFERRED - Use for most tasks
Task(subagent_type="oh-my-claudecode:executor-low", model="haiku", prompt="...")
Task(subagent_type="oh-my-claudecode:explore", model="haiku", prompt="...")
Task(subagent_type="oh-my-claudecode:architect-low", model="haiku", prompt="...")
// FALLBACK - Only if LOW fails
Task(subagent_type="oh-my-claudecode:executor", model="sonnet", prompt="...")
Task(subagent_type="oh-my-claudecode:architect-medium", model="sonnet", prompt="...")
// AVOID - Only for planning/critique if essential
Task(subagent_type="oh-my-claudecode:planner", model="opus", prompt="...")
Delegation Enforcement
Ecomode maintains all delegation rules from core protocol with cost-optimized routing:
| Action | Delegate To | Model |
|---|---|---|
| Code changes | executor-low / executor | haiku / sonnet |
| Analysis | architect-low | haiku |
| Search | explore | haiku |
| Documentation | writer | haiku |
Background Execution
Long-running commands (install, build, test) run in background. Maximum 20 concurrent.
Token Savings Tips
- Batch similar tasks to one agent instead of spawning many
- Use explore (haiku) for file discovery, not architect
- Prefer executor-low for simple changes - only upgrade if it fails
- Use writer (haiku) for all documentation tasks
- Avoid opus agents unless the task genuinely requires deep reasoning
Disabling Ecomode
Ecomode can be completely disabled via config. When disabled, all ecomode keywords are ignored.
Set in ~/.claude/.omc-config.json:
{
"ecomode": {
"enabled": false
}
}
State Management
Ecomode state is tracked in .omc/state/ecomode-state.json.
When work is complete, run /oh-my-claudecode:cancel for clean state cleanup.