oh-my-claude-sisyphus 3.8.15 → 3.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (259) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/.claude-plugin/plugin.json +1 -1
  3. package/.mcp.json +1 -1
  4. package/README.md +9 -11
  5. package/agents/analyst.md +41 -0
  6. package/agents/architect.md +45 -0
  7. package/agents/critic.md +42 -0
  8. package/agents/deep-executor.md +193 -0
  9. package/agents/planner.md +82 -0
  10. package/bridge/mcp-server.cjs +1 -1
  11. package/commands/autopilot.md +2 -6
  12. package/commands/hud.md +7 -2
  13. package/commands/ralph.md +3 -3
  14. package/commands/ultrapilot.md +2 -6
  15. package/dist/__tests__/agent-registry.test.js +1 -1
  16. package/dist/__tests__/delegation-enforcement-levels.test.js +0 -1
  17. package/dist/__tests__/delegation-enforcement-levels.test.js.map +1 -1
  18. package/dist/__tests__/hooks/learner/parser.test.d.ts +5 -0
  19. package/dist/__tests__/hooks/learner/parser.test.d.ts.map +1 -0
  20. package/dist/__tests__/hooks/learner/parser.test.js +201 -0
  21. package/dist/__tests__/hooks/learner/parser.test.js.map +1 -0
  22. package/dist/__tests__/hud/cwd.test.d.ts +2 -0
  23. package/dist/__tests__/hud/cwd.test.d.ts.map +1 -0
  24. package/dist/__tests__/hud/cwd.test.js +62 -0
  25. package/dist/__tests__/hud/cwd.test.js.map +1 -0
  26. package/dist/__tests__/hud/defaults.test.d.ts +2 -0
  27. package/dist/__tests__/hud/defaults.test.d.ts.map +1 -0
  28. package/dist/__tests__/hud/defaults.test.js +21 -0
  29. package/dist/__tests__/hud/defaults.test.js.map +1 -0
  30. package/dist/__tests__/hud/render.test.d.ts +2 -0
  31. package/dist/__tests__/hud/render.test.d.ts.map +1 -0
  32. package/dist/__tests__/hud/render.test.js +141 -0
  33. package/dist/__tests__/hud/render.test.js.map +1 -0
  34. package/dist/__tests__/hud/thinking.test.d.ts +2 -0
  35. package/dist/__tests__/hud/thinking.test.d.ts.map +1 -0
  36. package/dist/__tests__/hud/thinking.test.js +32 -0
  37. package/dist/__tests__/hud/thinking.test.js.map +1 -0
  38. package/dist/__tests__/installer.test.js +8 -8
  39. package/dist/__tests__/installer.test.js.map +1 -1
  40. package/dist/__tests__/mnemosyne/parser.test.js +1 -1
  41. package/dist/__tests__/mnemosyne/parser.test.js.map +1 -1
  42. package/dist/__tests__/omc-tools-server.test.js +2 -2
  43. package/dist/__tests__/omc-tools-server.test.js.map +1 -1
  44. package/dist/__tests__/skills.test.js +5 -4
  45. package/dist/__tests__/skills.test.js.map +1 -1
  46. package/dist/agents/deep-executor.d.ts +15 -0
  47. package/dist/agents/deep-executor.d.ts.map +1 -0
  48. package/dist/agents/deep-executor.js +47 -0
  49. package/dist/agents/deep-executor.js.map +1 -0
  50. package/dist/agents/definitions.d.ts +15 -0
  51. package/dist/agents/definitions.d.ts.map +1 -1
  52. package/dist/agents/definitions.js +25 -0
  53. package/dist/agents/definitions.js.map +1 -1
  54. package/dist/agents/index.d.ts +1 -0
  55. package/dist/agents/index.d.ts.map +1 -1
  56. package/dist/agents/index.js +1 -0
  57. package/dist/agents/index.js.map +1 -1
  58. package/dist/cli/commands/doctor-conflicts.d.ts +55 -0
  59. package/dist/cli/commands/doctor-conflicts.d.ts.map +1 -0
  60. package/dist/cli/commands/doctor-conflicts.js +261 -0
  61. package/dist/cli/commands/doctor-conflicts.js.map +1 -0
  62. package/dist/cli/index.js +16 -1
  63. package/dist/cli/index.js.map +1 -1
  64. package/dist/features/auto-update.d.ts +12 -0
  65. package/dist/features/auto-update.d.ts.map +1 -1
  66. package/dist/features/auto-update.js +4 -1
  67. package/dist/features/auto-update.js.map +1 -1
  68. package/dist/features/context-injector/types.d.ts +1 -1
  69. package/dist/features/context-injector/types.d.ts.map +1 -1
  70. package/dist/features/continuation-enforcement.js +1 -1
  71. package/dist/features/state-manager/index.d.ts.map +1 -1
  72. package/dist/features/state-manager/index.js +7 -4
  73. package/dist/features/state-manager/index.js.map +1 -1
  74. package/dist/features/verification/example.d.ts.map +1 -1
  75. package/dist/features/verification/example.js +4 -2
  76. package/dist/features/verification/example.js.map +1 -1
  77. package/dist/hooks/__tests__/bridge.test.d.ts +2 -0
  78. package/dist/hooks/__tests__/bridge.test.d.ts.map +1 -0
  79. package/dist/hooks/__tests__/bridge.test.js +199 -0
  80. package/dist/hooks/__tests__/bridge.test.js.map +1 -0
  81. package/dist/hooks/beads-context/__tests__/index.test.d.ts +2 -0
  82. package/dist/hooks/beads-context/__tests__/index.test.d.ts.map +1 -0
  83. package/dist/hooks/beads-context/__tests__/index.test.js +150 -0
  84. package/dist/hooks/beads-context/__tests__/index.test.js.map +1 -0
  85. package/dist/hooks/beads-context/constants.d.ts +3 -0
  86. package/dist/hooks/beads-context/constants.d.ts.map +1 -0
  87. package/dist/hooks/beads-context/constants.js +35 -0
  88. package/dist/hooks/beads-context/constants.js.map +1 -0
  89. package/dist/hooks/beads-context/index.d.ts +21 -0
  90. package/dist/hooks/beads-context/index.d.ts.map +1 -0
  91. package/dist/hooks/beads-context/index.js +62 -0
  92. package/dist/hooks/beads-context/index.js.map +1 -0
  93. package/dist/hooks/beads-context/types.d.ts +7 -0
  94. package/dist/hooks/beads-context/types.d.ts.map +1 -0
  95. package/dist/hooks/beads-context/types.js +2 -0
  96. package/dist/hooks/beads-context/types.js.map +1 -0
  97. package/dist/hooks/bridge.d.ts +4 -0
  98. package/dist/hooks/bridge.d.ts.map +1 -1
  99. package/dist/hooks/bridge.js +80 -47
  100. package/dist/hooks/bridge.js.map +1 -1
  101. package/dist/hooks/index.d.ts +2 -1
  102. package/dist/hooks/index.d.ts.map +1 -1
  103. package/dist/hooks/index.js +4 -1
  104. package/dist/hooks/index.js.map +1 -1
  105. package/dist/hooks/learner/parser.d.ts.map +1 -1
  106. package/dist/hooks/learner/parser.js +12 -5
  107. package/dist/hooks/learner/parser.js.map +1 -1
  108. package/dist/hooks/mode-registry/index.d.ts +2 -0
  109. package/dist/hooks/mode-registry/index.d.ts.map +1 -1
  110. package/dist/hooks/mode-registry/index.js +8 -19
  111. package/dist/hooks/mode-registry/index.js.map +1 -1
  112. package/dist/hooks/permission-handler/index.d.ts.map +1 -1
  113. package/dist/hooks/permission-handler/index.js +3 -1
  114. package/dist/hooks/permission-handler/index.js.map +1 -1
  115. package/dist/hooks/persistent-mode/index.d.ts +1 -1
  116. package/dist/hooks/persistent-mode/index.d.ts.map +1 -1
  117. package/dist/hooks/persistent-mode/index.js +5 -33
  118. package/dist/hooks/persistent-mode/index.js.map +1 -1
  119. package/dist/hooks/ralph/index.d.ts +1 -1
  120. package/dist/hooks/ralph/index.d.ts.map +1 -1
  121. package/dist/hooks/ralph/index.js +1 -1
  122. package/dist/hooks/ralph/index.js.map +1 -1
  123. package/dist/hooks/ralph/loop.d.ts +1 -9
  124. package/dist/hooks/ralph/loop.d.ts.map +1 -1
  125. package/dist/hooks/ralph/loop.js +1 -37
  126. package/dist/hooks/ralph/loop.js.map +1 -1
  127. package/dist/hooks/ralph/prd.js +1 -1
  128. package/dist/hooks/ralph/verifier.d.ts +4 -5
  129. package/dist/hooks/ralph/verifier.d.ts.map +1 -1
  130. package/dist/hooks/ralph/verifier.js +7 -10
  131. package/dist/hooks/ralph/verifier.js.map +1 -1
  132. package/dist/hooks/session-end/index.d.ts +13 -0
  133. package/dist/hooks/session-end/index.d.ts.map +1 -1
  134. package/dist/hooks/session-end/index.js +69 -0
  135. package/dist/hooks/session-end/index.js.map +1 -1
  136. package/dist/hooks/setup/index.d.ts.map +1 -1
  137. package/dist/hooks/setup/index.js +12 -5
  138. package/dist/hooks/setup/index.js.map +1 -1
  139. package/dist/hooks/subagent-tracker/index.d.ts.map +1 -1
  140. package/dist/hooks/subagent-tracker/index.js +25 -9
  141. package/dist/hooks/subagent-tracker/index.js.map +1 -1
  142. package/dist/hooks/ultrawork/index.d.ts +2 -2
  143. package/dist/hooks/ultrawork/index.d.ts.map +1 -1
  144. package/dist/hooks/ultrawork/index.js +2 -46
  145. package/dist/hooks/ultrawork/index.js.map +1 -1
  146. package/dist/hud/elements/cwd.d.ts +15 -0
  147. package/dist/hud/elements/cwd.d.ts.map +1 -0
  148. package/dist/hud/elements/cwd.js +39 -0
  149. package/dist/hud/elements/cwd.js.map +1 -0
  150. package/dist/hud/elements/index.d.ts +1 -0
  151. package/dist/hud/elements/index.d.ts.map +1 -1
  152. package/dist/hud/elements/index.js +1 -0
  153. package/dist/hud/elements/index.js.map +1 -1
  154. package/dist/hud/elements/thinking.d.ts +7 -5
  155. package/dist/hud/elements/thinking.d.ts.map +1 -1
  156. package/dist/hud/elements/thinking.js +18 -6
  157. package/dist/hud/elements/thinking.js.map +1 -1
  158. package/dist/hud/index.js +5 -3
  159. package/dist/hud/index.js.map +1 -1
  160. package/dist/hud/omc-state.d.ts +1 -1
  161. package/dist/hud/omc-state.d.ts.map +1 -1
  162. package/dist/hud/omc-state.js +14 -31
  163. package/dist/hud/omc-state.js.map +1 -1
  164. package/dist/hud/render.d.ts +9 -0
  165. package/dist/hud/render.d.ts.map +1 -1
  166. package/dist/hud/render.js +27 -7
  167. package/dist/hud/render.js.map +1 -1
  168. package/dist/hud/state.d.ts +2 -2
  169. package/dist/hud/state.d.ts.map +1 -1
  170. package/dist/hud/state.js +4 -33
  171. package/dist/hud/state.js.map +1 -1
  172. package/dist/hud/transcript.d.ts +4 -1
  173. package/dist/hud/transcript.d.ts.map +1 -1
  174. package/dist/hud/transcript.js +4 -9
  175. package/dist/hud/transcript.js.map +1 -1
  176. package/dist/hud/types.d.ts +20 -1
  177. package/dist/hud/types.d.ts.map +1 -1
  178. package/dist/hud/types.js +38 -9
  179. package/dist/hud/types.js.map +1 -1
  180. package/dist/index.js +1 -1
  181. package/dist/index.js.map +1 -1
  182. package/dist/installer/__tests__/claude-md-merge.test.d.ts +6 -0
  183. package/dist/installer/__tests__/claude-md-merge.test.d.ts.map +1 -0
  184. package/dist/installer/__tests__/claude-md-merge.test.js +220 -0
  185. package/dist/installer/__tests__/claude-md-merge.test.js.map +1 -0
  186. package/dist/installer/__tests__/safe-installer.test.d.ts +6 -0
  187. package/dist/installer/__tests__/safe-installer.test.d.ts.map +1 -0
  188. package/dist/installer/__tests__/safe-installer.test.js +172 -0
  189. package/dist/installer/__tests__/safe-installer.test.js.map +1 -0
  190. package/dist/installer/hooks.d.ts +1 -1
  191. package/dist/installer/hooks.d.ts.map +1 -1
  192. package/dist/installer/hooks.js +4 -2
  193. package/dist/installer/hooks.js.map +1 -1
  194. package/dist/installer/index.d.ts +27 -1
  195. package/dist/installer/index.d.ts.map +1 -1
  196. package/dist/installer/index.js +209 -85
  197. package/dist/installer/index.js.map +1 -1
  198. package/dist/mcp/omc-tools-server.d.ts +1 -1
  199. package/dist/mcp/omc-tools-server.d.ts.map +1 -1
  200. package/dist/mcp/omc-tools-server.js +3 -3
  201. package/dist/mcp/omc-tools-server.js.map +1 -1
  202. package/dist/mcp/standalone-server.js +1 -1
  203. package/dist/mcp/standalone-server.js.map +1 -1
  204. package/dist/verification/tier-selector.d.ts +40 -0
  205. package/dist/verification/tier-selector.d.ts.map +1 -0
  206. package/dist/verification/tier-selector.js +95 -0
  207. package/dist/verification/tier-selector.js.map +1 -0
  208. package/dist/verification/tier-selector.test.d.ts +2 -0
  209. package/dist/verification/tier-selector.test.d.ts.map +1 -0
  210. package/dist/verification/tier-selector.test.js +282 -0
  211. package/dist/verification/tier-selector.test.js.map +1 -0
  212. package/docs/AGENTS.md +100 -0
  213. package/docs/ARCHITECTURE.md +11 -7
  214. package/docs/CLAUDE.md +89 -379
  215. package/docs/DELEGATION-ENFORCER.md +1 -2
  216. package/docs/MIGRATION.md +1 -1
  217. package/docs/REFERENCE.md +29 -9
  218. package/docs/SYNC-SYSTEM.md +0 -2
  219. package/docs/partials/agent-tiers.md +165 -0
  220. package/docs/partials/features.md +131 -0
  221. package/docs/partials/mode-hierarchy.md +120 -0
  222. package/docs/partials/mode-selection-guide.md +82 -0
  223. package/docs/partials/verification-tiers.md +107 -0
  224. package/docs/shared/agent-tiers.md +165 -0
  225. package/docs/shared/features.md +131 -0
  226. package/docs/shared/mode-hierarchy.md +120 -0
  227. package/docs/shared/mode-selection-guide.md +82 -0
  228. package/docs/shared/verification-tiers.md +107 -0
  229. package/package.json +4 -3
  230. package/scripts/compose-docs.mjs +44 -0
  231. package/scripts/keyword-detector.mjs +13 -3
  232. package/scripts/persistent-mode.mjs +78 -47
  233. package/scripts/test-mutual-exclusion.ts +3 -3
  234. package/skills/AGENTS.md +59 -44
  235. package/skills/autopilot/SKILL.md +0 -2
  236. package/skills/cancel/SKILL.md +13 -32
  237. package/skills/deep-executor/SKILL.md +50 -0
  238. package/skills/ecomode/SKILL.md +58 -104
  239. package/skills/hud/SKILL.md +3 -2
  240. package/skills/omc-setup/SKILL.md +197 -20
  241. package/skills/plan/SKILL.md +62 -0
  242. package/skills/project-session-manager/SKILL.md +87 -4
  243. package/skills/project-session-manager/lib/config.sh +54 -5
  244. package/skills/project-session-manager/lib/parse.sh +65 -11
  245. package/skills/project-session-manager/lib/providers/github.sh +52 -0
  246. package/skills/project-session-manager/lib/providers/interface.sh +76 -0
  247. package/skills/project-session-manager/lib/providers/jira.sh +79 -0
  248. package/skills/project-session-manager/lib/session.sh +49 -12
  249. package/skills/project-session-manager/lib/worktree.sh +37 -4
  250. package/skills/project-session-manager/psm.sh +116 -51
  251. package/skills/ralph/SKILL.md +48 -44
  252. package/skills/ultrawork/SKILL.md +56 -67
  253. package/templates/hooks/keyword-detector.mjs +21 -13
  254. package/templates/hooks/lib/stdin.mjs +62 -0
  255. package/templates/hooks/persistent-mode.mjs +75 -34
  256. package/templates/hooks/post-tool-use.mjs +8 -10
  257. package/templates/hooks/pre-tool-use.mjs +9 -6
  258. package/templates/hooks/session-start.mjs +7 -8
  259. package/agents/AGENTS.md +0 -144
@@ -7,6 +7,12 @@ description: Cancel any active OMC mode (autopilot, ralph, ultrawork, ecomode, u
7
7
 
8
8
  Intelligent cancellation that detects and cancels the active OMC mode.
9
9
 
10
+ **The cancel skill is the standard way to complete and exit any OMC mode.**
11
+ When the stop hook detects work is complete, it instructs the LLM to invoke
12
+ this skill for proper state cleanup. If cancel fails or is interrupted,
13
+ retry with `--force` flag, or wait for the 2-hour staleness timeout as
14
+ a last resort.
15
+
10
16
  ## What It Does
11
17
 
12
18
  Automatically detects which mode is active and cancels it:
@@ -80,9 +86,6 @@ This removes all state files:
80
86
  - `.omc/state/pipeline-state.json`
81
87
  - `.omc/state/plan-consensus.json`
82
88
  - `.omc/state/ralplan-state.json`
83
- - `~/.claude/ralph-state.json`
84
- - `~/.claude/ultrawork-state.json`
85
- - `~/.claude/ecomode-state.json`
86
89
 
87
90
  ## Implementation Steps
88
91
 
@@ -161,11 +164,6 @@ if [[ "$FORCE_MODE" == "true" ]]; then
161
164
  rm -f .omc/state/plan-consensus.json
162
165
  rm -f .omc/state/ralplan-state.json
163
166
 
164
- # Remove global state files
165
- rm -f ~/.claude/ralph-state.json
166
- rm -f ~/.claude/ultrawork-state.json
167
- rm -f ~/.claude/ecomode-state.json
168
-
169
167
  echo "All OMC modes cleared. You are free to start fresh."
170
168
  exit 0
171
169
  fi
@@ -189,13 +187,11 @@ if [[ -f .omc/state/autopilot-state.json ]]; then
189
187
  # Clean linked ultrawork first
190
188
  if [[ "$LINKED_UW" == "true" ]] && [[ -f .omc/state/ultrawork-state.json ]]; then
191
189
  rm -f .omc/state/ultrawork-state.json
192
- rm -f ~/.claude/ultrawork-state.json
193
190
  echo "Cleaned up: ultrawork (linked to ralph)"
194
191
  fi
195
192
 
196
193
  # Clean ralph
197
194
  rm -f .omc/state/ralph-state.json
198
- rm -f ~/.claude/ralph-state.json
199
195
  rm -f .omc/state/ralph-verification.json
200
196
  echo "Cleaned up: ralph"
201
197
  fi
@@ -234,14 +230,12 @@ if [[ -f .omc/state/ralph-state.json ]]; then
234
230
  # Only clear if it was linked to ralph
235
231
  if [[ "$UW_LINKED" == "true" ]]; then
236
232
  rm -f .omc/state/ultrawork-state.json
237
- rm -f ~/.claude/ultrawork-state.json
238
233
  echo "Cleaned up: ultrawork (linked to ralph)"
239
234
  fi
240
235
  fi
241
236
 
242
- # Clean ralph state (both local and global)
237
+ # Clean ralph state
243
238
  rm -f .omc/state/ralph-state.json
244
- rm -f ~/.claude/ralph-state.json
245
239
  rm -f .omc/state/ralph-plan-state.json
246
240
  rm -f .omc/state/ralph-verification.json
247
241
 
@@ -264,9 +258,8 @@ if [[ -f .omc/state/ultrawork-state.json ]]; then
264
258
  exit 1
265
259
  fi
266
260
 
267
- # Remove both local and global state
261
+ # Remove local state
268
262
  rm -f .omc/state/ultrawork-state.json
269
- rm -f ~/.claude/ultrawork-state.json
270
263
 
271
264
  echo "Ultrawork cancelled. Parallel execution mode deactivated."
272
265
  fi
@@ -314,7 +307,7 @@ fi
314
307
  if [[ "$FORCE_MODE" == "true" ]]; then
315
308
  echo "FORCE CLEAR: Removing all OMC state files..."
316
309
 
317
- mkdir -p .omc ~/.claude
310
+ mkdir -p .omc/state
318
311
 
319
312
  # Remove local state files
320
313
  rm -f .omc/state/autopilot-state.json
@@ -333,11 +326,6 @@ if [[ "$FORCE_MODE" == "true" ]]; then
333
326
  rm -f .omc/state/plan-consensus.json
334
327
  rm -f .omc/state/ralplan-state.json
335
328
 
336
- # Remove global state files
337
- rm -f ~/.claude/ralph-state.json
338
- rm -f ~/.claude/ultrawork-state.json
339
- rm -f ~/.claude/ecomode-state.json
340
-
341
329
  echo ""
342
330
  echo "All OMC modes cleared. You are free to start fresh."
343
331
  exit 0
@@ -366,13 +354,11 @@ if [[ -f .omc/state/autopilot-state.json ]]; then
366
354
  # Clean linked ultrawork first
367
355
  if [[ "$LINKED_UW" == "true" ]] && [[ -f .omc/state/ultrawork-state.json ]]; then
368
356
  rm -f .omc/state/ultrawork-state.json
369
- rm -f ~/.claude/ultrawork-state.json
370
357
  CLEANED_UP+=("ultrawork")
371
358
  fi
372
359
 
373
360
  # Clean ralph
374
361
  rm -f .omc/state/ralph-state.json
375
- rm -f ~/.claude/ralph-state.json
376
362
  rm -f .omc/state/ralph-verification.json
377
363
  CLEANED_UP+=("ralph")
378
364
  fi
@@ -420,7 +406,6 @@ if [[ -f .omc/state/ralph-state.json ]]; then
420
406
  # Only clear if it was linked to ralph
421
407
  if [[ "$UW_LINKED" == "true" ]]; then
422
408
  rm -f .omc/state/ultrawork-state.json
423
- rm -f ~/.claude/ultrawork-state.json
424
409
  echo "Cleaned up: ultrawork (linked to ralph)"
425
410
  fi
426
411
  fi
@@ -434,14 +419,12 @@ if [[ -f .omc/state/ralph-state.json ]]; then
434
419
 
435
420
  if [[ "$ECO_LINKED" == "true" ]]; then
436
421
  rm -f .omc/state/ecomode-state.json
437
- rm -f ~/.claude/ecomode-state.json
438
422
  echo "Cleaned up: ecomode (linked to ralph)"
439
423
  fi
440
424
  fi
441
425
 
442
- # Clean ralph state (both local and global)
426
+ # Clean ralph state
443
427
  rm -f .omc/state/ralph-state.json
444
- rm -f ~/.claude/ralph-state.json
445
428
  rm -f .omc/state/ralph-plan-state.json
446
429
  rm -f .omc/state/ralph-verification.json
447
430
 
@@ -464,9 +447,8 @@ if [[ -f .omc/state/ultrawork-state.json ]]; then
464
447
  echo "Clearing ultrawork state anyway..."
465
448
  fi
466
449
 
467
- # Remove both local and global state
450
+ # Remove local state
468
451
  rm -f .omc/state/ultrawork-state.json
469
- rm -f ~/.claude/ultrawork-state.json
470
452
 
471
453
  echo "Ultrawork cancelled. Parallel execution mode deactivated."
472
454
  CANCELLED_ANYTHING=true
@@ -487,9 +469,8 @@ if [[ -f .omc/state/ecomode-state.json ]]; then
487
469
  echo "Clearing ecomode state anyway..."
488
470
  fi
489
471
 
490
- # Remove both local and global state
472
+ # Remove local state
491
473
  rm -f .omc/state/ecomode-state.json
492
- rm -f ~/.claude/ecomode-state.json
493
474
 
494
475
  echo "Ecomode cancelled. Token-efficient execution mode deactivated."
495
476
  CANCELLED_ANYTHING=true
@@ -636,5 +617,5 @@ fi
636
617
  - **Dependency-aware**: Autopilot cancellation cleans up Ralph and UltraQA
637
618
  - **Link-aware**: Ralph cancellation cleans up linked Ultrawork or Ecomode
638
619
  - **Safe**: Only clears linked Ultrawork, preserves standalone Ultrawork
639
- - **Dual-location**: Clears both `.omc/` and `~/.claude/` state files
620
+ - **Local-only**: Clears state files in `.omc/state/` directory
640
621
  - **Resume-friendly**: Autopilot state is preserved for seamless resume
@@ -0,0 +1,50 @@
1
+ ---
2
+ name: deep-executor
3
+ description: Deep executor mode for complex goal-oriented tasks
4
+ ---
5
+
6
+ # Deep Executor Skill
7
+
8
+ Activate autonomous deep work mode for complex tasks.
9
+
10
+ ## Overview
11
+
12
+ Deep Executor is the autonomous deep worker agent. When activated, it:
13
+
14
+ 1. **Explores First**: Uses its own tools (Glob, Grep, Read, ast_grep_search) to thoroughly understand the problem
15
+ 2. **Plans Strategically**: Creates execution plan based on exploration
16
+ 3. **Executes Directly**: Does all work itself using Edit, Write, Bash, ast_grep_replace
17
+ 4. **Verifies Everything**: Runs builds, tests, and diagnostics before claiming completion
18
+ 5. **Completes 100%**: Guarantees full completion with evidence
19
+
20
+ ## Usage
21
+
22
+ ```
23
+ /oh-my-claudecode:deep-executor <your complex task>
24
+ ```
25
+
26
+ Or use magic keywords:
27
+ - "deep-executor: ..."
28
+ - "deep work: ..."
29
+ - "forge: ..."
30
+
31
+ ## When to Use
32
+
33
+ | Situation | Use Deep Executor? |
34
+ |-----------|-----------------|
35
+ | Complex multi-file refactoring | YES |
36
+ | Unclear implementation path | YES |
37
+ | Need guaranteed completion | YES |
38
+ | Simple single-file fix | NO (use executor) |
39
+ | Quick code search | NO (use explore) |
40
+ | Cost-sensitive work | NO (use ecomode) |
41
+
42
+ ## Activation
43
+
44
+ This skill spawns the `deep-executor` agent via:
45
+
46
+ ```
47
+ Task(subagent_type="oh-my-claudecode:deep-executor", model="opus", prompt="{{PROMPT}}")
48
+ ```
49
+
50
+ The agent handles all exploration and execution internally. No sub-agents are spawned.
@@ -1,142 +1,96 @@
1
1
  ---
2
2
  name: ecomode
3
- description: Token-efficient parallel execution mode using Haiku and Sonnet agents
3
+ description: Token-efficient model routing modifier
4
4
  ---
5
5
 
6
6
  # Ecomode Skill
7
7
 
8
- Activates token-efficient parallel execution for pro-plan users who prioritize cost efficiency.
8
+ Token-efficient model routing. This is a **MODIFIER**, not a standalone execution mode.
9
9
 
10
- ## When Activated
10
+ ## What Ecomode Does
11
11
 
12
- This skill enhances Claude's capabilities by:
12
+ Overrides default model selection to prefer cheaper tiers:
13
13
 
14
- 1. **Parallel Execution**: Running multiple agents simultaneously for independent tasks
15
- 2. **Token-Conscious Routing**: Preferring Haiku and Sonnet agents, avoiding Opus
16
- 3. **Background Operations**: Using `run_in_background: true` for long operations
17
- 4. **Persistence Enforcement**: Never stopping until all tasks are verified complete
18
- 5. **Cost Optimization**: Minimizing token usage while maintaining quality
14
+ | Default Tier | Ecomode Override |
15
+ |--------------|------------------|
16
+ | HIGH (opus) | MEDIUM (sonnet), HIGH only if essential |
17
+ | MEDIUM (sonnet) | LOW (haiku) first, MEDIUM if fails |
18
+ | LOW (haiku) | LOW (haiku) - no change |
19
19
 
20
- ## Ecomode Routing Rules (CRITICAL)
20
+ ## What Ecomode Does NOT Do
21
21
 
22
- **ALWAYS prefer lower tiers. Only escalate when task genuinely requires it.**
23
-
24
- | Decision | Rule |
25
- |----------|------|
26
- | DEFAULT | Use LOW tier (Haiku) for all tasks |
27
- | UPGRADE | Use MEDIUM (Sonnet) only when task complexity warrants |
28
- | AVOID | HIGH tier (Opus) - only use for planning/critique if explicitly essential |
22
+ - **Persistence**: Use `ralph` for "don't stop until done"
23
+ - **Parallel Execution**: Use `ultrawork` for parallel agents
24
+ - **Delegation Enforcement**: Always active via core orchestration
29
25
 
30
- ## Smart Model Routing (PREFER LOW TIER)
26
+ ## Combining Ecomode with Other Modes
31
27
 
32
- **Choose tier based on task complexity: LOW (haiku) preferred → MEDIUM (sonnet) fallback → HIGH (opus) AVOID**
28
+ Ecomode is a modifier that combines with execution modes:
33
29
 
34
- ### Agent Routing Table
30
+ | Combination | Effect |
31
+ |-------------|--------|
32
+ | `eco ralph` | Ralph loop with cheaper agents |
33
+ | `eco ultrawork` | Parallel execution with cheaper agents |
34
+ | `eco autopilot` | Full autonomous with cost optimization |
35
35
 
36
- | Domain | PREFERRED (Haiku) | FALLBACK (Sonnet) | AVOID (Opus) |
37
- |--------|-------------------|-------------------|--------------|
38
- | **Analysis** | `architect-low` | `architect-medium` | ~~`architect`~~ |
39
- | **Execution** | `executor-low` | `executor` | ~~`executor-high`~~ |
40
- | **Search** | `explore` | `explore-medium` | ~~`explore-high`~~ |
41
- | **Research** | `researcher-low` | `researcher` | - |
42
- | **Frontend** | `designer-low` | `designer` | ~~`designer-high`~~ |
43
- | **Docs** | `writer` | - | - |
44
- | **Visual** | - | `vision` | - |
45
- | **Planning** | - | - | `planner` (if essential) |
46
- | **Critique** | - | - | `critic` (if essential) |
47
- | **Testing** | - | `qa-tester` | ~~`qa-tester-high`~~ |
48
- | **Security** | `security-reviewer-low` | - | ~~`security-reviewer`~~ |
49
- | **Build** | `build-fixer-low` | `build-fixer` | - |
50
- | **TDD** | `tdd-guide-low` | `tdd-guide` | - |
51
- | **Code Review** | `code-reviewer-low` | - | ~~`code-reviewer`~~ |
52
- | **Data Science** | `scientist-low` | `scientist` | ~~`scientist-high`~~ |
36
+ ## Ecomode Routing Rules
53
37
 
54
- ### Tier Selection Guide (Token-Conscious)
55
-
56
- | Task Complexity | Tier | Examples |
57
- |-----------------|------|----------|
58
- | Simple lookups | LOW | "What does this function return?", "Find where X is defined" |
59
- | Standard work | LOW first, MEDIUM if fails | "Add error handling", "Implement this feature" |
60
- | Complex analysis | MEDIUM | "Debug this issue", "Refactor this module" |
61
- | Planning only | HIGH (if essential) | "Design architecture for new system" |
38
+ **ALWAYS prefer lower tiers. Only escalate when task genuinely requires it.**
62
39
 
63
- ### Routing Examples
40
+ | Decision | Rule |
41
+ |----------|------|
42
+ | DEFAULT | Use LOW tier (Haiku) for all tasks |
43
+ | UPGRADE | Use MEDIUM (Sonnet) only when task complexity warrants |
44
+ | AVOID | HIGH tier (Opus) - only for planning/critique if essential |
64
45
 
65
- **CRITICAL: Always pass `model` parameter explicitly - Claude Code does NOT auto-apply models from agent definitions!**
46
+ ## Agent Selection in Ecomode
66
47
 
48
+ **FIRST ACTION:** Before delegating any work, read the agent reference file:
67
49
  ```
68
- // Simple question → LOW tier (DEFAULT)
69
- Task(subagent_type="oh-my-claudecode:architect-low", model="haiku", prompt="What does this function return?")
70
-
71
- // Standard implementation → TRY LOW first
72
- Task(subagent_type="oh-my-claudecode:executor-low", model="haiku", prompt="Add validation to login form")
73
-
74
- // If LOW fails, escalate to MEDIUM
75
- Task(subagent_type="oh-my-claudecode:executor", model="sonnet", prompt="Add error handling to login")
76
-
77
- // File lookup → ALWAYS LOW
78
- Task(subagent_type="oh-my-claudecode:explore", model="haiku", prompt="Find where UserService is defined")
79
-
80
- // Only use MEDIUM for complex patterns
81
- Task(subagent_type="oh-my-claudecode:explore-medium", model="sonnet", prompt="Find all authentication patterns in the codebase")
50
+ Read file: docs/shared/agent-tiers.md
82
51
  ```
52
+ This provides the complete agent tier matrix, MCP tool assignments, and selection guidance.
83
53
 
84
- ## DELEGATION ENFORCEMENT (CRITICAL)
85
-
86
- **YOU ARE AN ORCHESTRATOR, NOT AN IMPLEMENTER.**
87
-
88
- | Action | YOU Do | DELEGATE |
89
- |--------|--------|----------|
90
- | Read files for context | ✓ | |
91
- | Track progress (TODO) | ✓ | |
92
- | Spawn parallel agents | ✓ | |
93
- | **ANY code change** | ✗ NEVER | executor-low/executor |
94
- | **UI work** | ✗ NEVER | designer-low/designer |
95
- | **Docs** | ✗ NEVER | writer |
54
+ **Ecomode preference order:**
96
55
 
97
- **Path Exception**: Only write to `.omc/`, `.claude/`, `CLAUDE.md`, `AGENTS.md`
56
+ ```
57
+ // PREFERRED - Use for most tasks
58
+ Task(subagent_type="oh-my-claudecode:executor-low", model="haiku", prompt="...")
59
+ Task(subagent_type="oh-my-claudecode:explore", model="haiku", prompt="...")
60
+ Task(subagent_type="oh-my-claudecode:architect-low", model="haiku", prompt="...")
98
61
 
99
- ## Background Execution Rules
62
+ // FALLBACK - Only if LOW fails
63
+ Task(subagent_type="oh-my-claudecode:executor", model="sonnet", prompt="...")
64
+ Task(subagent_type="oh-my-claudecode:architect-medium", model="sonnet", prompt="...")
100
65
 
101
- **Run in Background** (set `run_in_background: true`):
102
- - Package installation: npm install, pip install, cargo build
103
- - Build processes: npm run build, make, tsc
104
- - Test suites: npm test, pytest, cargo test
105
- - Docker operations: docker build, docker pull
66
+ // AVOID - Only for planning/critique if essential
67
+ Task(subagent_type="oh-my-claudecode:planner", model="opus", prompt="...")
68
+ ```
106
69
 
107
- **Run Blocking** (foreground):
108
- - Quick status checks: git status, ls, pwd
109
- - File reads (NOT edits - delegate edits to executor-low)
110
- - Simple commands
70
+ ## Delegation Enforcement
111
71
 
112
- ## Verification Checklist
72
+ Ecomode maintains all delegation rules from core protocol with cost-optimized routing:
113
73
 
114
- Before stopping, verify:
115
- - [ ] TODO LIST: Zero pending/in_progress tasks
116
- - [ ] FUNCTIONALITY: All requested features work
117
- - [ ] TESTS: All tests pass (if applicable)
118
- - [ ] ERRORS: Zero unaddressed errors
74
+ | Action | Delegate To | Model |
75
+ |--------|-------------|-------|
76
+ | Code changes | executor-low / executor | haiku / sonnet |
77
+ | Analysis | architect-low | haiku |
78
+ | Search | explore | haiku |
79
+ | Documentation | writer | haiku |
119
80
 
120
- **If ANY checkbox is unchecked, CONTINUE WORKING.**
81
+ ### Background Execution
82
+ Long-running commands (install, build, test) run in background. Maximum 5 concurrent.
121
83
 
122
84
  ## Token Savings Tips
123
85
 
124
86
  1. **Batch similar tasks** to one agent instead of spawning many
125
87
  2. **Use explore (haiku)** for file discovery, not architect
126
88
  3. **Prefer executor-low** for simple changes - only upgrade if it fails
127
- 4. **Avoid opus agents** unless the task genuinely requires deep reasoning
128
- 5. **Use writer (haiku)** for all documentation tasks
129
-
130
- ## STATE CLEANUP ON COMPLETION
89
+ 4. **Use writer (haiku)** for all documentation tasks
90
+ 5. **Avoid opus agents** unless the task genuinely requires deep reasoning
131
91
 
132
- **IMPORTANT: Delete state files on completion - do NOT just set `active: false`**
92
+ ## State Management
133
93
 
134
- When ecomode completes (all verification passes):
135
-
136
- ```bash
137
- # Delete ecomode state files
138
- rm -f .omc/state/ecomode-state.json
139
- rm -f ~/.claude/ecomode-state.json
140
- ```
94
+ Ecomode state is tracked in `.omc/state/ecomode-state.json`.
141
95
 
142
- This ensures clean state for future sessions. Stale state files with `active: false` should not be left behind.
96
+ When work is complete, run `/oh-my-claudecode:cancel` for clean state cleanup.
@@ -246,7 +246,7 @@ HUD config is stored at: `~/.claude/.omc/hud-config.json`
246
246
 
247
247
  ## Manual Configuration
248
248
 
249
- You can manually edit the config file:
249
+ You can manually edit the config file. Each option can be set individually - any unset values will use defaults.
250
250
 
251
251
  ```json
252
252
  {
@@ -262,7 +262,8 @@ You can manually edit the config file:
262
262
  "backgroundTasks": true,
263
263
  "todos": true,
264
264
  "showCache": true,
265
- "showCost": true
265
+ "showCost": true,
266
+ "maxOutputLines": 4
266
267
  },
267
268
  "thresholds": {
268
269
  "contextWarning": 70,