1---2name: ultrawork-23description: [OMX] Parallel execution engine for high-throughput task completion4---56<Purpose>7Ultrawork 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.8</Purpose>910<Use_When>11- Multiple independent tasks can run simultaneously12- User says "ulw", "ultrawork", or wants parallel execution13- You need to delegate work to multiple agents at once14- Task benefits from concurrent execution but the user will manage completion themselves15</Use_When>1617<Do_Not_Use_When>18- Task requires guaranteed completion with verification -- use `ralph` instead (ralph includes ultrawork)19- Task requires a full autonomous pipeline -- use `autopilot` instead (autopilot includes ralph which includes ultrawork)20- There is only one sequential task with no parallelism opportunity -- delegate directly to an executor agent21- User needs session persistence for resume -- use `ralph` which adds persistence on top of ultrawork22</Do_Not_Use_When>2324<Why_This_Exists>25Sequential task execution wastes time when tasks are independent. Ultrawork enables firing multiple agents simultaneously and routing each to the right model tier, reducing total execution time while controlling token costs. It is designed as a composable component that ralph and autopilot layer on top of.26</Why_This_Exists>2728<Execution_Policy>29- Fire all independent agent calls simultaneously -- never serialize independent work30- Always pass the `model` parameter explicitly when delegating31- Read `docs/shared/agent-tiers.md` before first delegation for agent selection guidance32- Auto-delegate `researcher` when official docs, version-aware framework guidance, best practices, or external dependency behavior materially affect task correctness; treat it as an evidence lane, not a replacement primary workflow33- Use `run_in_background: true` for operations over ~30 seconds (installs, builds, tests)34- Run quick commands (git status, file reads, simple checks) in the foreground35</Execution_Policy>3637<Steps>381. **Read agent reference**: Load `docs/shared/agent-tiers.md` for tier selection392. **Classify tasks by independence**: Identify which tasks can run in parallel vs which have dependencies403. **Route to correct tiers**:41 - Simple lookups/definitions: LOW tier42 - Standard implementation: STANDARD tier43 - Complex analysis/refactoring: THOROUGH tier444. **Fire independent tasks simultaneously**: Launch all parallel-safe tasks at once455. **Run dependent tasks sequentially**: Wait for prerequisites before launching dependent work466. **Background long operations**: Builds, installs, and test suites use `run_in_background: true`477. **Verify when all tasks complete** (lightweight):48 - Build/typecheck passes49 - Affected tests pass50 - No new errors introduced51</Steps>5253<Tool_Usage>54- Use LOW-tier delegation for simple changes55- Use STANDARD-tier delegation for standard work56- Use THOROUGH-tier delegation for complex work57- Use `run_in_background: true` for package installs, builds, and test suites58- Use foreground execution for quick status checks and file operations59</Tool_Usage>6061## State Management6263Use `omx_state` MCP tools for ultrawork lifecycle state.6465- **On start**:66 `state_write({mode: "ultrawork", active: true, reinforcement_count: 1, started_at: "<now>"})`67- **On each reinforcement/loop step**:68 `state_write({mode: "ultrawork", reinforcement_count: <current>})`69- **On completion**:70 `state_write({mode: "ultrawork", active: false})`71- **On cancellation/cleanup**:72 run `$cancel` (which should call `state_clear(mode="ultrawork")`)7374<Examples>75<Good>76Three independent tasks fired simultaneously:77```78delegate(role="executor", tier="LOW", task="Add missing type export for Config interface")79delegate(role="executor", tier="STANDARD", task="Implement the /api/users endpoint with validation")80delegate(role="test-engineer", tier="STANDARD", task="Add integration tests for the auth middleware")81```82Why good: Independent tasks at appropriate tiers, all fired at once.83</Good>8485<Good>86Correct use of background execution:87```88delegate(role="executor", tier="STANDARD", task="npm install && npm run build", run_in_background=true)89delegate(role="writer", tier="LOW", task="Update the README with new API endpoints")90```91Why good: Long build runs in background while short task runs in foreground.92</Good>9394<Bad>95Sequential execution of independent work:96```97result1 = delegate(executor, LOW, "Add type export") # wait...98result2 = delegate(executor, STANDARD, "Implement endpoint") # wait...99result3 = delegate(test-engineer, STANDARD, "Add tests") # wait...100```101Why bad: These tasks are independent. Running them sequentially wastes time.102</Bad>103104<Bad>105Wrong tier selection:106```107delegate(role="executor", tier="THOROUGH", task="Add a missing semicolon")108```109Why bad: THOROUGH tier is expensive overkill for a trivial fix. Use LOW-tier execution instead.110</Bad>111</Examples>112113<Escalation_And_Stop_Conditions>114- When ultrawork is invoked directly (not via ralph), apply lightweight verification only -- build passes, tests pass, no new errors115- For full persistence and comprehensive architect verification, recommend switching to `ralph` mode116- If a task fails repeatedly across retries, report the issue rather than retrying indefinitely117- Escalate to the user when tasks have unclear dependencies or conflicting requirements118</Escalation_And_Stop_Conditions>119120<Final_Checklist>121- [ ] All parallel tasks completed122- [ ] Build/typecheck passes123- [ ] Affected tests pass124- [ ] No new errors introduced125</Final_Checklist>126127<Advanced>128## Relationship to Other Modes129130```131ralph (persistence wrapper)132 \-- includes: ultrawork (this skill)133 \-- provides: parallel execution only134135autopilot (autonomous execution)136 \-- includes: ralph137 \-- includes: ultrawork (this skill)138139ecomode (token efficiency)140 \-- modifies: ultrawork's model selection141```142143Ultrawork is the parallelism layer. Ralph adds persistence and verification. Autopilot adds the full lifecycle pipeline. Ecomode adjusts ultrawork's model routing to favor cheaper models.144</Advanced>
richard0901