ultrawork

<Purpose> Ultrawork is a parallel execution engine that runs multiple agents simultaneously for independent tasks. It is a component, not a standalone persistence mode -- it provides parallelism and smart model routing but not persistence, verification loops, or state management. </Purpose>

• Multiple independent tasks can run simultaneously
• User says "ulw", "ultrawork", or wants parallel execution
• You need to delegate work to multiple agents at once
• Task benefits from concurrent execution but the user will manage completion themselves </Use_When>

• Task requires guaranteed completion with verification -- use

  ralph

  instead (ralph includes ultrawork)
• Task requires a full autonomous pipeline -- use

  autopilot

  instead (autopilot includes ralph which includes ultrawork)
• There is only one sequential task with no parallelism opportunity -- delegate directly to an executor agent
• User needs session persistence for resume -- use

  ralph

  which adds persistence on top of ultrawork </Do_Not_Use_When>

• Fire all independent agent calls simultaneously -- never serialize independent work
• Always pass the

  model

  parameter explicitly when delegating
• Read

  docs/shared/agent-tiers.md

  before first delegation for agent selection guidance
• Use

  run_in_background: true

  for operations over ~30 seconds (installs, builds, tests)
• Run quick commands (git status, file reads, simple checks) in the foreground </Execution_Policy>

<Steps> 1. **Read agent reference**: Load `docs/shared/agent-tiers.md` for tier selection 2. **Classify tasks by independence**: Identify which tasks can run in parallel vs which have dependencies 3. **Route to correct tiers**: - Simple lookups/definitions: LOW tier (Haiku) - Standard implementation: MEDIUM tier (Sonnet) - Complex analysis/refactoring: HIGH tier (Opus) 4. **Fire independent tasks simultaneously**: Launch all parallel-safe tasks at once 5. **Run dependent tasks sequentially**: Wait for prerequisites before launching dependent work 6. **Background long operations**: Builds, installs, and test suites use `run_in_background: true` 7. **Verify when all tasks complete** (lightweight): - Build/typecheck passes - Affected tests pass - No new errors introduced </Steps>

• Use

  Task(subagent_type="oh-my-claudecode:executor-low", model="haiku", ...)

  for simple changes
• Use

  Task(subagent_type="oh-my-claudecode:executor", model="sonnet", ...)

  for standard work
• Use

  Task(subagent_type="oh-my-claudecode:executor-high", model="opus", ...)

  for complex work
• Use

  run_in_background: true

  for package installs, builds, and test suites
• Use foreground execution for quick status checks and file operations </Tool_Usage>

<Examples> <Good> Three independent tasks fired simultaneously: ``` Task(subagent_type="oh-my-claudecode:executor-low", model="haiku", prompt="Add missing type export for Config interface") Task(subagent_type="oh-my-claudecode:executor", model="sonnet", prompt="Implement the /api/users endpoint with validation") Task(subagent_type="oh-my-claudecode:executor", model="sonnet", prompt="Add integration tests for the auth middleware") ``` Why good: Independent tasks at appropriate tiers, all fired at once. </Good> <Good> Correct use of background execution: ``` Task(subagent_type="oh-my-claudecode:executor", model="sonnet", prompt="npm install && npm run build", run_in_background=true) Task(subagent_type="oh-my-claudecode:executor-low", model="haiku", prompt="Update the README with new API endpoints") ``` Why good: Long build runs in background while short task runs in foreground. </Good> <Bad> Sequential execution of independent work: ``` result1 = Task(executor-low, "Add type export") # wait... result2 = Task(executor, "Implement endpoint") # wait... result3 = Task(executor, "Add tests") # wait... ``` Why bad: These tasks are independent. Running them sequentially wastes time. </Bad> <Bad> Wrong tier selection: ``` Task(subagent_type="oh-my-claudecode:executor-high", model="opus", prompt="Add a missing semicolon") ``` Why bad: Opus is expensive overkill for a trivial fix. Use executor-low with Haiku instead. </Bad> </Examples>

• When ultrawork is invoked directly (not via ralph), apply lightweight verification only -- build passes, tests pass, no new errors
• For full persistence and comprehensive architect verification, recommend switching to

  ralph

  mode
• If a task fails repeatedly across retries, report the issue rather than retrying indefinitely
• Escalate to the user when tasks have unclear dependencies or conflicting requirements </Escalation_And_Stop_Conditions>

• All parallel tasks completed
• Build/typecheck passes
• Affected tests pass
• No new errors introduced </Final_Checklist>

<Advanced>

Task(subagent_type="oh-my-claudecode:executor-low", model="haiku", prompt="Add missing type export for Config interface")
Task(subagent_type="oh-my-claudecode:executor", model="sonnet", prompt="Implement the /api/users endpoint with validation")
Task(subagent_type="oh-my-claudecode:executor", model="sonnet", prompt="Add integration tests for the auth middleware")

Task(subagent_type="oh-my-claudecode:executor", model="sonnet", prompt="npm install && npm run build", run_in_background=true)
Task(subagent_type="oh-my-claudecode:executor-low", model="haiku", prompt="Update the README with new API endpoints")

result1 = Task(executor-low, "Add type export")  # 等待...
result2 = Task(executor, "Implement endpoint")     # 等待...
result3 = Task(executor, "Add tests")              # 等待...

Task(subagent_type="oh-my-claudecode:executor-high", model="opus", prompt="Add a missing semicolon")

ralph（持久化包装器）
 \-- 包含: ultrawork（本技能）
     \-- 提供: 仅并行执行

autopilot（自主执行）
 \-- 包含: ralph
     \-- 包含: ultrawork（本技能）

ecomode（Token效率模式）
 \-- 修改: ultrawork的模型选择逻辑