oh-my-claude-sisyphus 3.5.3 → 3.5.6

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 (54) hide show
  1. package/commands/doctor.md +1 -1
  2. package/commands/ecomode.md +1 -2
  3. package/commands/help.md +1 -1
  4. package/commands/learn-about-omc.md +5 -0
  5. package/commands/omc-setup.md +4 -4
  6. package/commands/ralplan.md +1 -1
  7. package/commands/research.md +2 -2
  8. package/commands/ultraqa.md +1 -1
  9. package/dist/__tests__/analytics/transcript-token-extractor.test.js +4 -2
  10. package/dist/__tests__/analytics/transcript-token-extractor.test.js.map +1 -1
  11. package/dist/__tests__/delegation-enforcer-integration.test.d.ts +4 -0
  12. package/dist/__tests__/delegation-enforcer-integration.test.d.ts.map +1 -1
  13. package/dist/__tests__/delegation-enforcer-integration.test.js +5 -1
  14. package/dist/__tests__/delegation-enforcer-integration.test.js.map +1 -1
  15. package/dist/__tests__/skills.test.js +17 -19
  16. package/dist/__tests__/skills.test.js.map +1 -1
  17. package/dist/hooks/auto-slash-command/constants.d.ts.map +1 -1
  18. package/dist/hooks/auto-slash-command/constants.js +1 -4
  19. package/dist/hooks/auto-slash-command/constants.js.map +1 -1
  20. package/dist/hooks/ralph/loop.js +1 -1
  21. package/dist/hooks/ralph/loop.js.map +1 -1
  22. package/dist/hooks/ultraqa/index.js +1 -1
  23. package/dist/hooks/ultraqa/index.js.map +1 -1
  24. package/docs/CLAUDE.md +9 -16
  25. package/docs/FULL-README.md +49 -56
  26. package/docs/MIGRATION.md +96 -1
  27. package/package.json +1 -1
  28. package/scripts/install.sh +8 -217
  29. package/scripts/uninstall.sh +0 -4
  30. package/skills/autopilot/SKILL.md +1 -1
  31. package/skills/cancel/SKILL.md +35 -0
  32. package/skills/doctor/SKILL.md +1 -1
  33. package/skills/help/SKILL.md +2 -2
  34. package/skills/learn-about-omc/SKILL.md +128 -0
  35. package/skills/mcp-setup/SKILL.md +63 -75
  36. package/skills/omc-setup/SKILL.md +4 -4
  37. package/skills/ralplan/SKILL.md +19 -250
  38. package/skills/research/SKILL.md +2 -2
  39. package/skills/ultrapilot/SKILL.md +1 -1
  40. package/skills/ultraqa/SKILL.md +1 -1
  41. package/commands/cancel-autopilot.md +0 -35
  42. package/commands/cancel-ecomode.md +0 -71
  43. package/commands/cancel-ralph.md +0 -41
  44. package/commands/cancel-ultraqa.md +0 -27
  45. package/commands/cancel-ultrawork.md +0 -40
  46. package/commands/planner.md +0 -174
  47. package/skills/cancel-autopilot/SKILL.md +0 -52
  48. package/skills/cancel-ecomode/SKILL.md +0 -41
  49. package/skills/cancel-ralph/SKILL.md +0 -42
  50. package/skills/cancel-ultraqa/SKILL.md +0 -28
  51. package/skills/cancel-ultrawork/SKILL.md +0 -41
  52. package/skills/omc-default/SKILL.md +0 -77
  53. package/skills/omc-default-global/SKILL.md +0 -74
  54. package/skills/planner/SKILL.md +0 -105
@@ -193,7 +193,7 @@ Chain agents with data passing between stages:
193
193
  | Preset | Stages |
194
194
  |--------|--------|
195
195
  | `review` | explore → architect → critic → executor |
196
- | `implement` | planner → executor → tdd-guide |
196
+ | `implement` | analyst → executor → tdd-guide |
197
197
  | `debug` | explore → architect → build-fixer |
198
198
  | `research` | parallel(researcher, explore) → architect → writer |
199
199
  | `refactor` | explore → architect-medium → executor-high → qa-tester |
@@ -223,7 +223,7 @@ Smart cancellation that auto-detects active mode:
223
223
 
224
224
  **Auto-detects and cancels:** autopilot, ultrapilot, ralph, ultrawork, ultraqa, ecomode, swarm, pipeline
225
225
 
226
- **Deprecation notice:** Individual cancel commands (`cancel-ralph`, `cancel-ultraqa`, `cancel-ultrawork`, `cancel-ecomode`) still work but are deprecated. Use `/oh-my-claudecode:cancel` instead.
226
+ **Removed in v3.5.3:** Individual cancel commands (`cancel-ralph`, `cancel-ultraqa`, `cancel-ultrawork`, `cancel-ecomode`, `cancel-autopilot`) have been removed. Use `/oh-my-claudecode:cancel` instead.
227
227
 
228
228
  ### 🔍 Explore-High Agent
229
229
 
@@ -293,7 +293,7 @@ chmod +x scripts/install.sh
293
293
  Configure omc for the current project only:
294
294
 
295
295
  ```
296
- /oh-my-claudecode:omc-default
296
+ /oh-my-claudecode:omc-setup
297
297
  ```
298
298
 
299
299
  - Creates `./.claude/CLAUDE.md` in your current project
@@ -306,7 +306,7 @@ Configure omc for the current project only:
306
306
  Configure omc for all Claude Code sessions:
307
307
 
308
308
  ```
309
- /oh-my-claudecode:omc-default-global
309
+ /oh-my-claudecode:omc-setup
310
310
  ```
311
311
 
312
312
  - Creates `~/.claude/CLAUDE.md` globally
@@ -338,7 +338,7 @@ Without running one of these commands, Claude operates with basic capabilities.
338
338
  - **First time**: Run after installation (choose project or global)
339
339
  - **After updates**: Re-run to get the latest configuration
340
340
  - **Different machines**: Run on each machine where you use Claude Code
341
- - **New projects**: Run `/oh-my-claudecode:omc-default` in each project that needs omc
341
+ - **New projects**: Run `/oh-my-claudecode:omc-setup --local` in each project that needs omc
342
342
 
343
343
  ### Configuration Precedence
344
344
 
@@ -348,7 +348,7 @@ If both configurations exist, **project-scoped takes precedence** over global:
348
348
  ./.claude/CLAUDE.md (project) → Overrides → ~/.claude/CLAUDE.md (global)
349
349
  ```
350
350
 
351
- > **NOTE**: After updating the plugin (via `npm update`, `git pull`, or Claude Code's plugin update), you MUST re-run `/oh-my-claudecode:omc-default` or `/oh-my-claudecode:omc-default-global` to apply the latest CLAUDE.md changes. The plugin update does NOT automatically update your CLAUDE.md files.
351
+ > **NOTE**: After updating the plugin (via `npm update`, `git pull`, or Claude Code's plugin update), you MUST re-run `/oh-my-claudecode:omc-setup` to apply the latest CLAUDE.md changes. The plugin update does NOT automatically update your CLAUDE.md files.
352
352
 
353
353
  ---
354
354
 
@@ -363,8 +363,8 @@ oh-my-claudecode/
363
363
  ├── .claude-plugin/
364
364
  │ └── plugin.json # Plugin manifest
365
365
  ├── agents/ # 32 specialized agents (tiered: architect, executor, explore, etc.)
366
- ├── commands/ # 37 slash commands
367
- ├── skills/ # 40 skills (orchestrate, ultrawork, ultrapilot, swarm, pipeline, ecomode, ralph, planner, research, tdd, build-fix, code-review, security-review, and more)
366
+ ├── commands/ # 30 slash commands
367
+ ├── skills/ # 35 skills (orchestrate, ultrawork, ultrapilot, swarm, pipeline, ecomode, ralph, plan, research, tdd, build-fix, code-review, security-review, and more)
368
368
  ├── hooks/
369
369
  │ └── hooks.json # Hook configuration
370
370
  └── scripts/ # Hook scripts
@@ -386,21 +386,37 @@ The installer adds to your Claude Code config (`~/.claude/`):
386
386
  │ ├── critic.md # Plan reviewer (Opus)
387
387
  │ ├── analyst.md # Pre-planning consultant (Opus)
388
388
  │ ├── executor.md # Focused executor (Sonnet)
389
- │ ├── planner.md # Strategic planner (Opus)
390
389
  │ └── qa-tester.md # CLI/service testing (Sonnet)
391
390
  ├── commands/
392
- │ ├── orchestrate.md # /oh-my-claudecode:orchestrate command
393
- │ ├── omc-default.md # /oh-my-claudecode:omc-default command (project-scoped)
394
- │ ├── omc-default-global.md # /oh-my-claudecode:omc-default-global command (global)
395
- │ ├── ultrawork.md # /oh-my-claudecode:ultrawork command
396
- │ ├── deepsearch.md # /oh-my-claudecode:deepsearch command
397
391
  │ ├── analyze.md # /oh-my-claudecode:analyze command
398
- │ ├── plan.md # /oh-my-claudecode:plan command (planner)
399
- │ ├── review.md # /oh-my-claudecode:review command (critic)
400
- │ ├── planner.md # /oh-my-claudecode:planner command
401
- │ ├── orchestrator.md # /oh-my-claudecode:orchestrator command
402
- │ ├── ralph-loop.md # /oh-my-claudecode:ralph-loop command
403
- └── cancel-ralph.md # /oh-my-claudecode:cancel-ralph command
392
+ │ ├── autopilot.md # /oh-my-claudecode:autopilot command
393
+ │ ├── build-fix.md # /oh-my-claudecode:build-fix command
394
+ │ ├── cancel.md # /oh-my-claudecode:cancel command
395
+ │ ├── code-review.md # /oh-my-claudecode:code-review command
396
+ │ ├── deepinit.md # /oh-my-claudecode:deepinit command
397
+ ├── deepsearch.md # /oh-my-claudecode:deepsearch command
398
+ │ ├── doctor.md # /oh-my-claudecode:doctor command
399
+ │ ├── ecomode.md # /oh-my-claudecode:ecomode command
400
+ │ ├── help.md # /oh-my-claudecode:help command
401
+ │ ├── hud.md # /oh-my-claudecode:hud command
402
+ │ ├── learner.md # /oh-my-claudecode:learner command
403
+ │ ├── mcp-setup.md # /oh-my-claudecode:mcp-setup command
404
+ │ ├── note.md # /oh-my-claudecode:note command
405
+ │ ├── omc-setup.md # /oh-my-claudecode:omc-setup command
406
+ │ ├── pipeline.md # /oh-my-claudecode:pipeline command
407
+ │ ├── plan.md # /oh-my-claudecode:plan command
408
+ │ ├── ralph-init.md # /oh-my-claudecode:ralph-init command
409
+ │ ├── ralph.md # /oh-my-claudecode:ralph command
410
+ │ ├── ralplan.md # /oh-my-claudecode:ralplan command
411
+ │ ├── release.md # /oh-my-claudecode:release command
412
+ │ ├── research.md # /oh-my-claudecode:research command
413
+ │ ├── review.md # /oh-my-claudecode:review command
414
+ │ ├── security-review.md # /oh-my-claudecode:security-review command
415
+ │ ├── swarm.md # /oh-my-claudecode:swarm command
416
+ │ ├── tdd.md # /oh-my-claudecode:tdd command
417
+ │ ├── ultrapilot.md # /oh-my-claudecode:ultrapilot command
418
+ │ ├── ultraqa.md # /oh-my-claudecode:ultraqa command
419
+ │ └── ultrawork.md # /oh-my-claudecode:ultrawork command
404
420
  ├── skills/
405
421
  │ ├── ultrawork/SKILL.md # Maximum performance mode
406
422
  │ ├── deepinit/SKILL.md # Hierarchical AGENTS.md generation
@@ -424,21 +440,16 @@ claude
424
440
  | Command | Description |
425
441
  |---------|-------------|
426
442
  | `/oh-my-claudecode:orchestrate <task>` | Activate multi-agent orchestration mode |
427
- | `/oh-my-claudecode:omc-default` | Configure omc for current project (./.claude/CLAUDE.md) |
428
- | `/oh-my-claudecode:omc-default-global` | Configure omc globally (~/.claude/CLAUDE.md) |
429
443
  | `/oh-my-claudecode:ultrawork <task>` | Maximum performance mode with parallel agents |
430
444
  | `/oh-my-claudecode:ralph-init <task>` | Initialize PRD (Product Requirements Document) for structured task tracking |
431
445
  | `/oh-my-claudecode:ralph <task>` | Self-referential loop until task completion |
432
446
  | `/oh-my-claudecode:ultraqa <goal>` | Autonomous QA cycling workflow (test → verify → fix → repeat) |
433
- | `/oh-my-claudecode:cancel-ralph` | Cancel active Ralph Loop |
434
- | `/oh-my-claudecode:cancel-ultraqa` | Cancel active UltraQA cycling workflow |
435
447
  | `/oh-my-claudecode:note <content>` | Save notes to notepad.md for compaction resilience |
436
448
  | `/oh-my-claudecode:deepsearch <query>` | Thorough multi-strategy codebase search |
437
449
  | `/oh-my-claudecode:deepinit [path]` | Index codebase with hierarchical AGENTS.md files |
438
450
  | `/oh-my-claudecode:analyze <target>` | Deep analysis and investigation |
439
- | `/oh-my-claudecode:plan <description>` | Start planning session with planner |
451
+ | `/oh-my-claudecode:plan <description>` | Start planning session |
440
452
  | `/oh-my-claudecode:review [plan-path]` | Review a plan with critic |
441
- | `/oh-my-claudecode:planner <task>` | Strategic planning with interview workflow |
442
453
  | `/oh-my-claudecode:doctor` | Diagnose and fix installation issues |
443
454
 
444
455
  ### Examples
@@ -449,12 +460,6 @@ claude
449
460
  # Activate orchestration for a task
450
461
  /oh-my-claudecode:orchestrate refactor the authentication module
451
462
 
452
- # Configure for current project
453
- /oh-my-claudecode:omc-default
454
-
455
- # Or configure globally for all projects
456
- /oh-my-claudecode:omc-default-global
457
-
458
463
  # Use ultrawork for maximum performance
459
464
  /oh-my-claudecode:ultrawork implement user dashboard with charts
460
465
 
@@ -558,7 +563,7 @@ Oh-my-claudecode includes 19 lifecycle hooks that enhance Claude Code's behavior
558
563
 
559
564
  ## Builtin Skills
560
565
 
561
- 40 builtin skills provide specialized capabilities:
566
+ 35 builtin skills provide specialized capabilities:
562
567
 
563
568
  ### Core Skills
564
569
  | Skill | Description |
@@ -573,7 +578,6 @@ Oh-my-claudecode includes 19 lifecycle hooks that enhance Claude Code's behavior
573
578
  | **ralph** | Self-referential development until completion |
574
579
  | **ralph-init** | Initialize PRD for structured task tracking |
575
580
  | **ultraqa** | Autonomous QA cycling workflow |
576
- | **planner** | Strategic planning with interview workflow |
577
581
  | **plan** | Start planning session |
578
582
  | **ralplan** | Iterative planning (Planner+Architect+Critic) |
579
583
  | **review** | Review work plans with critic |
@@ -595,13 +599,6 @@ Oh-my-claudecode includes 19 lifecycle hooks that enhance Claude Code's behavior
595
599
  |-------|-------------|
596
600
  | **note** | Save notes to compaction-resilient notepad |
597
601
  | **cancel** | Unified cancellation for all modes (v3.4.0) |
598
- | **cancel-autopilot** | Cancel autopilot (deprecated - use cancel) |
599
- | **cancel-ralph** | Cancel Ralph Loop (deprecated - use cancel) |
600
- | **cancel-ultraqa** | Cancel UltraQA (deprecated - use cancel) |
601
- | **cancel-ultrawork** | Cancel ultrawork (deprecated - use cancel) |
602
- | **cancel-ecomode** | Cancel ecomode (deprecated - use cancel) |
603
- | **omc-default** | Configure omc for current project |
604
- | **omc-default-global** | Configure omc globally |
605
602
  | **omc-setup** | One-time setup wizard |
606
603
  | **doctor** | Diagnose and fix installation issues |
607
604
  | **help** | Show OMC usage guide |
@@ -611,8 +608,6 @@ Oh-my-claudecode includes 19 lifecycle hooks that enhance Claude Code's behavior
611
608
 
612
609
  Skills are automatically activated via slash commands or magic keywords.
613
610
 
614
- **Note:** Individual cancel commands (`cancel-ralph`, `cancel-ultraqa`, `cancel-ultrawork`, `cancel-ecomode`, `cancel-autopilot`) are deprecated in v3.4.0. Use the unified `/oh-my-claudecode:cancel` command instead, which auto-detects the active mode.
615
-
616
611
  ---
617
612
 
618
613
  ## Intelligent Skill Activation
@@ -625,7 +620,7 @@ Skills work in **three composable layers**:
625
620
 
626
621
  | Layer | Skills | Purpose |
627
622
  |-------|--------|---------|
628
- | **Execution** | orchestrate, orchestrator, planner | HOW you work (pick primary) |
623
+ | **Execution** | orchestrate, orchestrator, plan | HOW you work (pick primary) |
629
624
  | **Enhancement** | ultrawork, git-master, frontend-ui-ux | ADD capabilities (stack multiple) |
630
625
  | **Guarantee** | ralph-loop | ENSURE completion |
631
626
 
@@ -643,7 +638,7 @@ Claude uses judgment to detect task type and activate appropriate skill combinat
643
638
  | + must complete | `orchestrate + ralph-loop` | User emphasizes completion |
644
639
  | UI/frontend work | `orchestrate + frontend-ui-ux` | Components, styling |
645
640
  | Complex debugging | `architect` → `orchestrate` | Root cause → fix |
646
- | Strategic planning | `planner` | Need plan first |
641
+ | Strategic planning | `plan` | Need plan first |
647
642
  | Maximum performance | `ultrawork` (stacks) | Speed critical |
648
643
 
649
644
  ### Examples
@@ -656,7 +651,7 @@ Claude uses judgment to detect task type and activate appropriate skill combinat
656
651
  → ultrawork + orchestrate + git-master
657
652
 
658
653
  "Plan auth system, then implement it completely"
659
- planner (first) → orchestrate + ralph-loop (after plan)
654
+ plan (first) → orchestrate + ralph-loop (after plan)
660
655
 
661
656
  "Fix this bug, don't stop until it's done"
662
657
  → orchestrate + ralph-loop
@@ -684,7 +679,6 @@ Claude will automatically delegate to these specialized agents:
684
679
 
685
680
  | | Agent | Model | Best For |
686
681
  |---|-------|-------|----------|
687
- | **planner** | Opus | Strategic planning, comprehensive work plans, interview-style requirement gathering |
688
682
  | **critic** | Opus | Critical plan review, feasibility assessment, risk identification |
689
683
  | **analyst** | Opus | Pre-planning analysis, hidden requirement detection, ambiguity resolution |
690
684
 
@@ -755,8 +749,8 @@ curl -fsSL https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claudecode/main/s
755
749
  Or manually:
756
750
 
757
751
  ```bash
758
- rm ~/.claude/agents/{architect,researcher,explore,designer,writer,vision,critic,analyst,executor,planner,qa-tester}.md
759
- rm ~/.claude/commands/{orchestrate,omc-default,omc-default-global,ultrawork,deepsearch,analyze,plan,review,planner,orchestrator,ralph-loop,cancel-ralph}.md
752
+ rm ~/.claude/agents/{architect,researcher,explore,designer,writer,vision,critic,analyst,executor,qa-tester}.md
753
+ rm ~/.claude/commands/{analyze,autopilot,deepsearch,plan,review,ultrawork}.md
760
754
  ```
761
755
 
762
756
  ---
@@ -798,9 +792,9 @@ for await (const message of query({
798
792
  ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
799
793
  │ PLANNING │ │ EXECUTION │ │ SUPPORT │
800
794
  ├─────────────────┤ ├─────────────────┤ ├─────────────────┤
801
- planner │ │ architect │ │ researcher │
802
- critic │ │ designer │ │ explore │
803
- analyst │ │ orchestrator │ │ writer │
795
+ critic │ │ architect │ │ researcher │
796
+ analyst │ │ designer │ │ explore │
797
+ │ │ orchestrator │ │ writer │
804
798
  │ │ │ executor │ │ vision │
805
799
  └─────────────────┘ └─────────────────┘ └─────────────────┘
806
800
  ```
@@ -834,7 +828,6 @@ The original oh-my-opencode used multiple AI providers. This project uses Claude
834
828
  | **critic** | GPT-5.2 | Claude Opus | Plan reviewer |
835
829
  | **analyst** | Claude Opus 4.5 | Claude Opus | Pre-planning consultant |
836
830
  | **executor** | Configurable | Claude Sonnet | Focused task executor |
837
- | **planner** | Planning System | Claude Opus | Strategic planner |
838
831
 
839
832
  **Why Claude-only?** The Claude Agent SDK is designed for Claude models. Using Claude throughout provides:
840
833
  - Consistent behavior and capabilities
@@ -892,9 +885,9 @@ The original oh-my-opencode used multiple AI providers. This project uses Claude
892
885
 
893
886
  | Feature | Description |
894
887
  |---------|-------------|
895
- | **32 Specialized Agents** | architect, researcher, explore, designer, writer, vision, qa-tester, critic, analyst, executor, planner (+ tiered variants: -low, -medium, -high) + security-reviewer, build-fixer, tdd-guide, code-reviewer, scientist (all with tier variants) |
888
+ | **32 Specialized Agents** | architect, researcher, explore, designer, writer, vision, qa-tester, critic, analyst, executor (+ tiered variants: -low, -medium, -high) + security-reviewer, build-fixer, tdd-guide, code-reviewer, scientist (all with tier variants) |
896
889
  | **19 Lifecycle Hooks** | rules-injector, omc-orchestrator, auto-slash-command, keyword-detector, ralph-loop, todo-continuation, notepad, post-tool-use, context-window-limit-recovery, preemptive-compaction, session-recovery, directory-readme-injector, comment-checker, thinking-block-validator, empty-message-sanitizer, edit-error-recovery, non-interactive-env, agent-usage-reminder, background-notification |
897
- | **37 Builtin Skills** | orchestrate, autopilot, ultrawork, ultrapilot, swarm, pipeline, ecomode, ralph, ralph-init, ultraqa, planner, plan, ralplan, review, deepinit, deepsearch, analyze, research, frontend-ui-ux, git-master, tdd, learner, note, cancel (unified), cancel-autopilot, cancel-ralph, cancel-ultraqa, cancel-ultrawork, cancel-ecomode, omc-default, omc-default-global, omc-setup, doctor, help, hud, release, mcp-setup |
890
+ | **35 Builtin Skills** | orchestrate, autopilot, ultrawork, ultrapilot, swarm, pipeline, ecomode, ralph, ralph-init, ultraqa, plan, ralplan, review, deepinit, deepsearch, analyze, research, frontend-ui-ux, git-master, tdd, learner, note, cancel, omc-setup, doctor, help, hud, release, mcp-setup |
898
891
  | **Magic Keywords** | `ultrawork`, `search`, `analyze`, `ultrathink` trigger enhanced modes |
899
892
  | **Slash Commands** | All skills available via `/oh-my-claudecode:skill-name` (e.g., `/oh-my-claudecode:ultrawork`, `/oh-my-claudecode:ralph`, `/oh-my-claudecode:plan`) |
900
893
  | **Compaction-Resilient Memory** | Three-tier notepad system (Priority Context, Working Memory, MANUAL) |
@@ -972,7 +965,7 @@ If you're coming from oh-my-opencode:
972
965
  2. **LSP Workflows**: All LSP tools are available! Use `lsp_servers` to check which servers are installed
973
966
  3. **AST Searches**: Use `ast_grep_search` with pattern syntax (e.g., `function $NAME($$$)`)
974
967
  4. **Background Tasks**: Claude Code's `Task` tool with `run_in_background` works similarly
975
- 5. **Planning**: Use `/oh-my-claudecode:plan` command to start a planning session with planner
968
+ 5. **Planning**: Use `/oh-my-claudecode:plan` command to start a planning session
976
969
 
977
970
  </details>
978
971
 
package/docs/MIGRATION.md CHANGED
@@ -6,12 +6,107 @@ This guide covers all migration paths for oh-my-claudecode. Find your current ve
6
6
 
7
7
  ## Table of Contents
8
8
 
9
+ - [v3.5.3 → v3.5.5: Test Fixes & Cleanup](#v353--v355-test-fixes--cleanup)
10
+ - [v3.5.2 → v3.5.3: Skill Consolidation](#v35--v36-skill-consolidation)
9
11
  - [v2.x → v3.0: Package Rename & Auto-Activation](#v2x--v30-package-rename--auto-activation)
10
12
  - [v3.0 → v3.1: Notepad Wisdom & Enhanced Features](#v30--v31-notepad-wisdom--enhanced-features)
11
13
  - [v3.x → v4.0: Major Architecture Overhaul](#v3x--v40-major-architecture-overhaul)
12
14
 
13
15
  ---
14
16
 
17
+ ## v3.5.3 → v3.5.5: Test Fixes & Cleanup
18
+
19
+ ### TL;DR
20
+
21
+ Maintenance release fixing test suite issues and continuing skill consolidation from v3.5.3.
22
+
23
+ ### What Changed
24
+
25
+ **Test Fixes:**
26
+ - Delegation-enforcer tests marked as skipped (implementation pending)
27
+ - Analytics expectations corrected for agent attribution
28
+ - All remaining tests now pass cleanly
29
+
30
+ **Skill Consolidation:**
31
+ - Continued cleanup from v3.5.3
32
+ - Removed deprecated `cancel-*` skills (use `/cancel` instead)
33
+ - Final skill count: 35 core skills
34
+
35
+ ### Migration Steps
36
+
37
+ 1. **No breaking changes** - All functionality preserved
38
+ 2. **Test suite** now runs cleanly with `npm run test:run`
39
+ 3. **Deprecated skills** removed (already replaced in v3.5.3)
40
+
41
+ ### For Developers
42
+
43
+ If you were depending on deprecated `cancel-*` skills, update to use the unified `/cancel` command which auto-detects the active mode.
44
+
45
+ ---
46
+
47
+ ## v3.5.2 → v3.5.3: Skill Consolidation
48
+
49
+ ### TL;DR
50
+
51
+ 8 deprecated skills have been removed. The unified `/cancel` and `/omc-setup` commands replace them.
52
+
53
+ ### Removed Skills
54
+
55
+ The following skills have been **completely removed** in v3.5.3:
56
+
57
+ | Removed Skill | Replacement |
58
+ |---------------|-------------|
59
+ | `cancel-autopilot` | `/oh-my-claudecode:cancel` |
60
+ | `cancel-ralph` | `/oh-my-claudecode:cancel` |
61
+ | `cancel-ultrawork` | `/oh-my-claudecode:cancel` |
62
+ | `cancel-ultraqa` | `/oh-my-claudecode:cancel` |
63
+ | `cancel-ecomode` | `/oh-my-claudecode:cancel` |
64
+ | `omc-default` | `/oh-my-claudecode:omc-setup --local` |
65
+ | `omc-default-global` | `/oh-my-claudecode:omc-setup --global` |
66
+ | `planner` | `/oh-my-claudecode:plan` |
67
+
68
+ ### What Changed
69
+
70
+ **Before v3.5.3:**
71
+ ```bash
72
+ /oh-my-claudecode:cancel-ralph # Cancel ralph specifically
73
+ /oh-my-claudecode:omc-default # Configure local project
74
+ /oh-my-claudecode:planner "task" # Start planning
75
+ ```
76
+
77
+ **After v3.5.3:**
78
+ ```bash
79
+ /oh-my-claudecode:cancel # Auto-detects and cancels any active mode
80
+ /oh-my-claudecode:omc-setup --local # Configure local project
81
+ /oh-my-claudecode:plan "task" # Start planning (includes interview mode)
82
+ ```
83
+
84
+ ### New Features
85
+
86
+ **New skill: `/learn-about-omc`**
87
+ - Analyzes your OMC usage patterns
88
+ - Provides personalized recommendations
89
+ - Identifies underutilized features
90
+
91
+ **Plan skill now supports consensus mode:**
92
+ ```bash
93
+ /oh-my-claudecode:plan --consensus "task" # Iterative planning with Critic review
94
+ /oh-my-claudecode:ralplan "task" # Alias for plan --consensus
95
+ ```
96
+
97
+ ### Migration Steps
98
+
99
+ 1. **No action required** - The unified `/cancel` command already worked in v3.5
100
+ 2. **Update any scripts** that reference removed commands
101
+ 3. **Re-run `/omc-setup`** if you want to update your CLAUDE.md configuration
102
+
103
+ ### Skill Count
104
+
105
+ - v3.5: 42 skills
106
+ - v3.5.3: 35 skills (8 removed, 1 added)
107
+
108
+ ---
109
+
15
110
  ## v2.x → v3.0: Package Rename & Auto-Activation
16
111
 
17
112
  ### TL;DR
@@ -836,7 +931,7 @@ A: No. Keywords are optional shortcuts. Claude auto-detects intent without them.
836
931
  A: No. All commands continue to work across minor versions (3.0 → 3.1). Major version changes (3.x → 4.0) will provide migration paths.
837
932
 
838
933
  **Q: What if I like explicit commands?**
839
- A: Keep using them! `/oh-my-claudecode:ralph`, `/oh-my-claudecode:ultrawork`, `/oh-my-claudecode:planner` all still work.
934
+ A: Keep using them! `/oh-my-claudecode:ralph`, `/oh-my-claudecode:ultrawork`, and `/oh-my-claudecode:plan` work. Note: `/oh-my-claudecode:planner` now redirects to `/oh-my-claudecode:plan`.
840
935
 
841
936
  **Q: How do I know what Claude is doing?**
842
937
  A: Claude announces major behaviors: "I'm activating ralph-loop..." or set up `/oh-my-claudecode:hud` for real-time status.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "oh-my-claude-sisyphus",
3
- "version": "3.5.3",
3
+ "version": "3.5.6",
4
4
  "description": "Multi-agent orchestration system for Claude Code - Inspired by oh-my-opencode",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -720,161 +720,6 @@ Delegate tasks to specialized agents using the Task tool:
720
720
  - NEVER leave work incomplete
721
721
  CMD_EOF
722
722
 
723
- # omc-default mode command (project-scoped)
724
- cat > "$CLAUDE_CONFIG_DIR/commands/omc-default.md" << 'CMD_EOF'
725
- ---
726
- description: Configure oh-my-claudecode in local project (.claude/CLAUDE.md)
727
- ---
728
-
729
- $ARGUMENTS
730
-
731
- ## Task: Configure oh-my-claudecode Default Mode (Project-Scoped)
732
-
733
- **CRITICAL**: This skill ALWAYS downloads fresh CLAUDE.md from GitHub to your local project. DO NOT use the Write tool - use bash curl exclusively.
734
-
735
- ### Step 1: Create Local .claude Directory
736
-
737
- Ensure the local project has a .claude directory:
738
-
739
- ```bash
740
- # Create .claude directory in current project
741
- mkdir -p .claude && echo "✅ .claude directory created" || echo "❌ Failed to create .claude directory"
742
- ```
743
-
744
- ### Step 2: Download Fresh CLAUDE.md (MANDATORY)
745
-
746
- Execute this bash command to download fresh CLAUDE.md to local project config:
747
-
748
- ```bash
749
- # Download fresh CLAUDE.md to project-local .claude/
750
- curl -fsSL "https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claude-sisyphus/main/docs/CLAUDE.md" -o .claude/CLAUDE.md && \
751
- echo "✅ CLAUDE.md downloaded successfully to .claude/CLAUDE.md" || \
752
- echo "❌ Failed to download CLAUDE.md"
753
- ```
754
-
755
- **MANDATORY**: Always run this command. Do NOT skip. Do NOT use Write tool.
756
-
757
- **FALLBACK** if curl fails:
758
- Tell user to manually download from:
759
- https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claude-sisyphus/main/docs/CLAUDE.md
760
-
761
- ### Step 3: Verify Plugin Installation
762
-
763
- The oh-my-claudecode plugin provides all hooks automatically via the plugin system. Verify the plugin is enabled:
764
-
765
- ```bash
766
- grep -q "oh-my-claudecode" ~/.claude/settings.json && echo "Plugin enabled" || echo "Plugin NOT enabled"
767
- ```
768
-
769
- If plugin is not enabled, instruct user:
770
- > Run: `claude /install-plugin oh-my-claudecode` to enable the plugin.
771
-
772
- ### Step 4: Confirm Success
773
-
774
- After completing all steps, report:
775
-
776
- ✅ **oh-my-claudecode Project Configuration Complete**
777
- - CLAUDE.md: Updated with latest configuration from GitHub at ./.claude/CLAUDE.md
778
- - Scope: **PROJECT** - applies only to this project
779
- - Hooks: Provided by plugin (no manual installation needed)
780
- - Agents: 19+ available (base + tiered variants)
781
- - Model routing: Haiku/Sonnet/Opus based on task complexity
782
-
783
- **Note**: This configuration is project-specific and won't affect other projects or global settings.
784
-
785
- ---
786
-
787
- ## 🔄 Keeping Up to Date
788
-
789
- After installing oh-my-claudecode updates (via npm or plugin update), run `/omc-default` again in your project to get the latest CLAUDE.md configuration. This ensures you have the newest features and agent configurations.
790
-
791
- ---
792
-
793
- ## 🌍 Global vs Project Configuration
794
-
795
- - **`/omc-default`** (this command): Creates `./.claude/CLAUDE.md` in your current project
796
- - **`/omc-default-global`**: Creates `~/.claude/CLAUDE.md` for all projects
797
-
798
- Project-scoped configuration takes precedence over global configuration.
799
- CMD_EOF
800
-
801
- # omc-default-global mode command (global)
802
- cat > "$CLAUDE_CONFIG_DIR/commands/omc-default-global.md" << 'CMD_EOF'
803
- ---
804
- description: Configure oh-my-claudecode globally in ~/.claude/CLAUDE.md
805
- ---
806
-
807
- $ARGUMENTS
808
-
809
- ## Task: Configure oh-my-claudecode Default Mode (Global)
810
-
811
- **CRITICAL**: This skill ALWAYS downloads fresh CLAUDE.md from GitHub to your global config. DO NOT use the Write tool - use bash curl exclusively.
812
-
813
- ### Step 1: Download Fresh CLAUDE.md (MANDATORY)
814
-
815
- Execute this bash command to erase and download fresh CLAUDE.md to global config:
816
-
817
- ```bash
818
- # Remove existing CLAUDE.md and download fresh from GitHub
819
- rm -f ~/.claude/CLAUDE.md && \
820
- curl -fsSL "https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claude-sisyphus/main/docs/CLAUDE.md" -o ~/.claude/CLAUDE.md && \
821
- echo "✅ CLAUDE.md downloaded successfully to ~/.claude/CLAUDE.md" || \
822
- echo "❌ Failed to download CLAUDE.md"
823
- ```
824
-
825
- **MANDATORY**: Always run this command. Do NOT skip. Do NOT use Write tool.
826
-
827
- **FALLBACK** if curl fails:
828
- Tell user to manually download from:
829
- https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claude-sisyphus/main/docs/CLAUDE.md
830
-
831
- ### Step 2: Clean Up Legacy Hooks (if present)
832
-
833
- Check if old manual hooks exist and remove them to prevent duplicates:
834
-
835
- ```bash
836
- # Remove legacy bash hook scripts (now handled by plugin system)
837
- rm -f ~/.claude/hooks/keyword-detector.sh
838
- rm -f ~/.claude/hooks/stop-continuation.sh
839
- rm -f ~/.claude/hooks/persistent-mode.sh
840
- rm -f ~/.claude/hooks/session-start.sh
841
- ```
842
-
843
- Check `~/.claude/settings.json` for manual hook entries. If the "hooks" key exists with UserPromptSubmit, Stop, or SessionStart entries pointing to bash scripts, inform the user:
844
-
845
- > **Note**: Found legacy hooks in settings.json. These should be removed since the plugin now provides hooks automatically. Remove the "hooks" section from ~/.claude/settings.json to prevent duplicate hook execution.
846
-
847
- ### Step 3: Verify Plugin Installation
848
-
849
- The oh-my-claudecode plugin provides all hooks automatically via the plugin system. Verify the plugin is enabled:
850
-
851
- ```bash
852
- grep -q "oh-my-claudecode" ~/.claude/settings.json && echo "Plugin enabled" || echo "Plugin NOT enabled"
853
- ```
854
-
855
- If plugin is not enabled, instruct user:
856
- > Run: `claude /install-plugin oh-my-claudecode` to enable the plugin.
857
-
858
- ### Step 4: Confirm Success
859
-
860
- After completing all steps, report:
861
-
862
- ✅ **oh-my-claudecode Global Configuration Complete**
863
- - CLAUDE.md: Updated with latest configuration from GitHub at ~/.claude/CLAUDE.md
864
- - Scope: **GLOBAL** - applies to all Claude Code sessions
865
- - Hooks: Provided by plugin (no manual installation needed)
866
- - Agents: 19+ available (base + tiered variants)
867
- - Model routing: Haiku/Sonnet/Opus based on task complexity
868
-
869
- **Note**: Hooks are now managed by the plugin system automatically. No manual hook installation required.
870
-
871
- ---
872
-
873
- ## 🔄 Keeping Up to Date
874
-
875
- After installing oh-my-claudecode updates (via npm or plugin update), run `/omc-default-global` again to get the latest CLAUDE.md configuration. This ensures you have the newest features and agent configurations.
876
- CMD_EOF
877
-
878
723
  # Plan command (Prometheus planning system)
879
724
  cat > "$CLAUDE_CONFIG_DIR/commands/plan.md" << 'CMD_EOF'
880
725
  ---
@@ -1003,57 +848,7 @@ Plans are saved to `.omc/plans/` for later execution with `/sisyphus`.
1003
848
  Tell me about what you want to build or accomplish. I'll ask questions to understand the full scope before creating a plan.
1004
849
  CMD_EOF
1005
850
 
1006
- # Ralph Loop Command
1007
- cat > "$CLAUDE_CONFIG_DIR/commands/ralph-loop.md" << 'CMD_EOF'
1008
- ---
1009
- description: Start self-referential development loop until task completion
1010
- ---
1011
-
1012
- [RALPH LOOP ACTIVATED]
1013
-
1014
- $ARGUMENTS
1015
-
1016
- ## How Ralph Loop Works
1017
-
1018
- You are starting a Ralph Loop - a self-referential development loop that runs until task completion.
1019
-
1020
- 1. Work on the task continuously and thoroughly
1021
- 2. When the task is FULLY complete, output: `<promise>DONE</promise>`
1022
- 3. If you stop without the promise tag, the loop will remind you to continue
1023
- 4. Maximum iterations: 100 (configurable)
1024
-
1025
- ## Exit Conditions
1026
-
1027
- - **Completion**: Output `<promise>DONE</promise>` when fully done
1028
- - **Cancel**: User runs `/cancel-ralph`
1029
- - **Max Iterations**: Loop stops at limit
1030
-
1031
- ## Guidelines
1032
-
1033
- - Break the task into steps and work through them systematically
1034
- - Test your work as you go
1035
- - Don't output the promise until you've verified everything works
1036
- - Be thorough - the loop exists so you can take your time
1037
-
1038
- ---
1039
-
1040
- Begin working on the task. Remember to output `<promise>DONE</promise>` when complete.
1041
- CMD_EOF
1042
-
1043
- # Cancel Ralph Command
1044
- cat > "$CLAUDE_CONFIG_DIR/commands/cancel-ralph.md" << 'CMD_EOF'
1045
- ---
1046
- description: Cancel active Ralph Loop
1047
- ---
1048
-
1049
- [RALPH LOOP CANCELLED]
1050
-
1051
- The Ralph Loop has been cancelled. You can stop working on the current task.
1052
-
1053
- If you want to start a new loop, use `/ralph-loop "task description"`.
1054
- CMD_EOF
1055
-
1056
- echo -e "${GREEN}✓ Installed 10 slash commands${NC}"
851
+ echo -e "${GREEN}✓ Installed 8 slash commands${NC}"
1057
852
 
1058
853
  echo -e "${BLUE}[5/6]${NC} Installing hook scripts..."
1059
854
  mkdir -p "$CLAUDE_CONFIG_DIR/hooks"
@@ -1724,16 +1519,14 @@ Use the Task tool to delegate to specialized agents:
1724
1519
  | Command | Description |
1725
1520
  |---------|-------------|
1726
1521
  | `/orchestrate <task>` | Activate OMC multi-agent orchestration |
1727
- | `/omc-default` | Configure OMC for current project (./.claude/CLAUDE.md) |
1728
- | `/omc-default-global` | Configure OMC globally (~/.claude/CLAUDE.md) |
1522
+ | `/omc-setup` | Configure OMC (--local for project, --global for all) |
1729
1523
  | `/ultrawork <task>` | Maximum performance mode with parallel agents |
1730
1524
  | `/deepsearch <query>` | Thorough codebase search |
1731
1525
  | `/analyze <target>` | Deep analysis and investigation |
1732
- | `/plan <description>` | Start planning session with Planner |
1526
+ | `/plan <description>` | Start planning session |
1733
1527
  | `/review [plan-path]` | Review a plan with Critic |
1734
- | `/planner <task>` | Strategic planning with interview workflow |
1735
1528
  | `/ralph <task>` | Self-referential loop until task completion |
1736
- | `/cancel-ralph` | Cancel active Ralph Loop |
1529
+ | `/cancel` | Cancel active loops/modes |
1737
1530
 
1738
1531
  ## Planning Workflow
1739
1532
 
@@ -1833,8 +1626,7 @@ echo " claude # Start Claude Code normally"
1833
1626
  echo ""
1834
1627
  echo -e "${YELLOW}Slash Commands:${NC}"
1835
1628
  echo " /sisyphus <task> # Activate Sisyphus orchestration mode"
1836
- echo " /omc-default # Configure for current project"
1837
- echo " /omc-default-global # Configure globally"
1629
+ echo " /omc-setup # Configure OMC (--local or --global)"
1838
1630
  echo " /ultrawork <task> # Maximum performance mode"
1839
1631
  echo " /deepsearch <query> # Thorough codebase search"
1840
1632
  echo " /analyze <target> # Deep analysis mode"
@@ -1871,12 +1663,11 @@ echo " # Or run this install script again:"
1871
1663
  echo " curl -fsSL https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claude-sisyphus/main/scripts/install.sh | bash"
1872
1664
  echo ""
1873
1665
  echo -e "${YELLOW}After Updates:${NC}"
1874
- echo " Run '/omc-default' (project) or '/omc-default-global' (global)"
1875
- echo " to download the latest CLAUDE.md configuration."
1876
- echo " This ensures you get the newest features and agent behaviors."
1666
+ echo " Run '/omc-setup' to download the latest CLAUDE.md configuration."
1667
+ echo " Use '--local' for project or '--global' for all projects."
1877
1668
  echo ""
1878
1669
  echo -e "${BLUE}Quick Start:${NC}"
1879
1670
  echo " 1. Run 'claude' to start Claude Code"
1880
- echo " 2. Type '/omc-default' for project config or '/omc-default-global' for global"
1671
+ echo " 2. Type '/omc-setup' for configuration wizard"
1881
1672
  echo " 3. Or use '/sisyphus <task>' for one-time activation"
1882
1673
  echo ""