oh-my-codex 0.1.1

package/skills/ultraqa/SKILL.md

@@ -0,0 +1,130 @@
+---
+name: ultraqa
+description: QA cycling workflow - test, verify, fix, repeat until goal met
+---
+
+# UltraQA Skill
+
+[ULTRAQA ACTIVATED - AUTONOMOUS QA CYCLING]
+
+## Overview
+
+You are now in **ULTRAQA** mode - an autonomous QA cycling workflow that runs until your quality goal is met.
+
+**Cycle**: qa-tester → architect verification → fix → repeat
+
+## Goal Parsing
+
+Parse the goal from arguments. Supported formats:
+
+| Invocation | Goal Type | What to Check |
+|------------|-----------|---------------|
+| `/ultraqa --tests` | tests | All test suites pass |
+| `/ultraqa --build` | build | Build succeeds with exit 0 |
+| `/ultraqa --lint` | lint | No lint errors |
+| `/ultraqa --typecheck` | typecheck | No TypeScript errors |
+| `/ultraqa --custom "pattern"` | custom | Custom success pattern in output |
+
+If no structured goal provided, interpret the argument as a custom goal.
+
+## Cycle Workflow
+
+### Cycle N (Max 5)
+
+1. **RUN QA**: Execute verification based on goal type
+   - `--tests`: Run the project's test command
+   - `--build`: Run the project's build command
+   - `--lint`: Run the project's lint command
+   - `--typecheck`: Run the project's type check command
+   - `--custom`: Run appropriate command and check for pattern
+   - `--interactive`: Use qa-tester for interactive CLI/service testing:
+     ```
+     spawn_sub_agent(subagent_type="oh-my-codex:qa-tester", model="sonnet", prompt="TEST:
+     Goal: [describe what to verify]
+     Service: [how to start]
+     Test cases: [specific scenarios to verify]")
+     ```
+
+2. **CHECK RESULT**: Did the goal pass?
+   - **YES** → Exit with success message
+   - **NO** → Continue to step 3
+
+3. **ARCHITECT DIAGNOSIS**: Spawn architect to analyze failure
+   ```
+   spawn_sub_agent(subagent_type="oh-my-codex:architect", model="opus", prompt="DIAGNOSE FAILURE:
+   Goal: [goal type]
+   Output: [test/build output]
+   Provide root cause and specific fix recommendations.")
+   ```
+
+4. **FIX ISSUES**: Apply architect's recommendations
+   ```
+   spawn_sub_agent(subagent_type="oh-my-codex:executor", model="sonnet", prompt="FIX:
+   Issue: [architect diagnosis]
+   Files: [affected files]
+   Apply the fix precisely as recommended.")
+   ```
+
+5. **REPEAT**: Go back to step 1
+
+## Exit Conditions
+
+| Condition | Action |
+|-----------|--------|
+| **Goal Met** | Exit with success: "ULTRAQA COMPLETE: Goal met after N cycles" |
+| **Cycle 5 Reached** | Exit with diagnosis: "ULTRAQA STOPPED: Max cycles. Diagnosis: ..." |
+| **Same Failure 3x** | Exit early: "ULTRAQA STOPPED: Same failure detected 3 times. Root cause: ..." |
+| **Environment Error** | Exit: "ULTRAQA ERROR: [tmux/port/dependency issue]" |
+
+## Observability
+
+Output progress each cycle:
+```
+[ULTRAQA Cycle 1/5] Running tests...
+[ULTRAQA Cycle 1/5] FAILED - 3 tests failing
+[ULTRAQA Cycle 1/5] Architect diagnosing...
+[ULTRAQA Cycle 1/5] Fixing: auth.test.ts - missing mock
+[ULTRAQA Cycle 2/5] Running tests...
+[ULTRAQA Cycle 2/5] PASSED - All 47 tests pass
+[ULTRAQA COMPLETE] Goal met after 2 cycles
+```
+
+## State Tracking
+
+Use `omx_state` MCP tools for UltraQA lifecycle state.
+
+- **On start**:
+  `state_write({mode: "ultraqa", active: true, current_phase: "qa", iteration: 1, started_at: "<now>"})`
+- **On each cycle**:
+  `state_write({mode: "ultraqa", current_phase: "qa", iteration: <cycle>})`
+- **On diagnose/fix transitions**:
+  `state_write({mode: "ultraqa", current_phase: "diagnose"})`
+  `state_write({mode: "ultraqa", current_phase: "fix"})`
+- **On completion**:
+  `state_write({mode: "ultraqa", active: false, current_phase: "complete", completed_at: "<now>"})`
+- **For resume detection**:
+  `state_read({mode: "ultraqa"})`
+
+## Cancellation
+
+User can cancel with `/cancel` which clears the state file.
+
+## Important Rules
+
+1. **PARALLEL when possible** - Run diagnosis while preparing potential fixes
+2. **TRACK failures** - Record each failure to detect patterns
+3. **EARLY EXIT on pattern** - 3x same failure = stop and surface
+4. **CLEAR OUTPUT** - User should always know current cycle and status
+5. **CLEAN UP** - Clear state file on completion or cancellation
+
+## STATE CLEANUP ON COMPLETION
+
+When goal is met OR max cycles reached OR exiting early, run `$cancel` or call:
+
+`state_clear({mode: "ultraqa"})`
+
+Use MCP state cleanup rather than deleting files directly.
+
+---
+
+Begin ULTRAQA cycling now. Parse the goal and start cycle 1.

package/skills/ultrawork/SKILL.md

@@ -0,0 +1,143 @@
+---
+name: ultrawork
+description: Parallel execution engine for high-throughput task completion
+---
+
+<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>
+
+<Use_When>
+- 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>
+
+<Do_Not_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>
+
+<Why_This_Exists>
+Sequential 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.
+</Why_This_Exists>
+
+<Execution_Policy>
+- 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>
+
+<Tool_Usage>
+- Use `spawn_sub_agent(subagent_type="oh-my-codex:executor-low", model="haiku", ...)` for simple changes
+- Use `spawn_sub_agent(subagent_type="oh-my-codex:executor", model="sonnet", ...)` for standard work
+- Use `spawn_sub_agent(subagent_type="oh-my-codex: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>
+
+## State Management
+
+Use `omx_state` MCP tools for ultrawork lifecycle state.
+
+- **On start**:
+  `state_write({mode: "ultrawork", active: true, reinforcement_count: 1, started_at: "<now>"})`
+- **On each reinforcement/loop step**:
+  `state_write({mode: "ultrawork", reinforcement_count: <current>})`
+- **On completion**:
+  `state_write({mode: "ultrawork", active: false})`
+- **On cancellation/cleanup**:
+  run `$cancel` (which should call `state_clear(mode="ultrawork")`)
+
+<Examples>
+<Good>
+Three independent tasks fired simultaneously:
+```
+spawn_sub_agent(subagent_type="oh-my-codex:executor-low", model="haiku", prompt="Add missing type export for Config interface")
+spawn_sub_agent(subagent_type="oh-my-codex:executor", model="sonnet", prompt="Implement the /api/users endpoint with validation")
+spawn_sub_agent(subagent_type="oh-my-codex: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:
+```
+spawn_sub_agent(subagent_type="oh-my-codex:executor", model="sonnet", prompt="npm install && npm run build", run_in_background=true)
+spawn_sub_agent(subagent_type="oh-my-codex: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 = spawn_sub_agent(executor-low, "Add type export")  # wait...
+result2 = spawn_sub_agent(executor, "Implement endpoint")     # wait...
+result3 = spawn_sub_agent(executor, "Add tests")              # wait...
+```
+Why bad: These tasks are independent. Running them sequentially wastes time.
+</Bad>
+
+<Bad>
+Wrong tier selection:
+```
+spawn_sub_agent(subagent_type="oh-my-codex: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>
+
+<Escalation_And_Stop_Conditions>
+- 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>
+
+<Final_Checklist>
+- [ ] All parallel tasks completed
+- [ ] Build/typecheck passes
+- [ ] Affected tests pass
+- [ ] No new errors introduced
+</Final_Checklist>
+
+<Advanced>
+## Relationship to Other Modes
+
+```
+ralph (persistence wrapper)
+ \-- includes: ultrawork (this skill)
+     \-- provides: parallel execution only
+
+autopilot (autonomous execution)
+ \-- includes: ralph
+     \-- includes: ultrawork (this skill)
+
+ecomode (token efficiency)
+ \-- modifies: ultrawork's model selection
+```
+
+Ultrawork 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.
+</Advanced>