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
@@ -1,174 +0,0 @@
1
- ---
2
- description: Strategic planning consultant with interview workflow
3
- aliases: [planning, plan-interview]
4
- ---
5
-
6
- # Planner Command
7
-
8
- [PLANNER MODE ACTIVATED - INTERVIEW WORKFLOW]
9
-
10
- You are activating the Planner agent, a strategic planning consultant who creates comprehensive work plans through interview-style interaction.
11
-
12
- ## User's Request
13
-
14
- {{ARGUMENTS}}
15
-
16
- ## What Planner Does
17
-
18
- The Planner guides users through planning by:
19
-
20
- 1. **Interview Phase** - Asks clarifying questions about requirements, constraints, goals
21
- 2. **Analysis Phase** - Consults Analyst for hidden requirements and risk analysis
22
- 3. **Plan Creation** - Creates detailed, actionable work plans
23
-
24
- ## How It's Different from `/plan`
25
-
26
- | Command | Workflow | Use When |
27
- |---------|----------|----------|
28
- | `/planner` | Full interview workflow | Requirements unclear, complex project |
29
- | `/plan` | Quick planning, no interview | Requirements clear, simple task |
30
-
31
- ## Interview Protocol
32
-
33
- The Planner follows strict interview discipline:
34
-
35
- ### Single Question at a Time
36
-
37
- **NEVER** ask multiple questions in one message.
38
-
39
- **Good:**
40
- ```
41
- What's the primary scope for this feature?
42
- ```
43
-
44
- **Bad:**
45
- ```
46
- What's the scope? And the timeline? And who's the audience?
47
- ```
48
-
49
- ### Question Categories
50
-
51
- The Planner asks about:
52
- - **Goals** - What success looks like
53
- - **Constraints** - Time, budget, technical limits
54
- - **Context** - Existing systems, dependencies
55
- - **Risks** - What could go wrong
56
- - **Preferences** - Trade-offs (speed vs quality)
57
-
58
- ### Using AskUserQuestion Tool
59
-
60
- For preference questions, the Planner uses `AskUserQuestion` tool to provide clickable UI:
61
-
62
- **Question types requiring AskUserQuestion:**
63
- - Preference (speed vs quality)
64
- - Requirement (deadline)
65
- - Scope (include feature Y?)
66
- - Constraint (performance needs)
67
- - Risk tolerance (refactoring acceptable?)
68
-
69
- **Example:**
70
- ```
71
- AskUserQuestion(
72
- question="For performance, what matters more - latency or throughput?",
73
- type="preference",
74
- options=["Latency", "Throughput", "Both equally"]
75
- )
76
- ```
77
-
78
- ## Plan Quality Criteria
79
-
80
- Planner ensures:
81
- - 80%+ claims cite file/line references
82
- - 90%+ acceptance criteria are testable
83
- - No vague terms without metrics
84
- - All risks have mitigations
85
-
86
- ## Transition to Plan Creation
87
-
88
- Planner creates the plan when user says:
89
- - "Create the plan"
90
- - "Make it into a work plan"
91
- - "I'm ready to plan"
92
- - "Let's create the plan"
93
-
94
- ## Plan Structure
95
-
96
- The final plan includes:
97
-
98
- 1. **Requirements Summary** - What was gathered from interview
99
- 2. **Acceptance Criteria** - Testable conditions for completion
100
- 3. **Implementation Steps** - With file references
101
- 4. **Risks & Mitigations** - What could go wrong and how to handle
102
- 5. **Verification Steps** - How to verify completion
103
-
104
- ## Delegation to Planner Agent
105
-
106
- This command delegates to the `planner` agent (Opus model) which follows the full interview workflow.
107
-
108
- ```
109
- Task(
110
- subagent_type="oh-my-claudecode:planner",
111
- model="opus",
112
- prompt="PLANNING REQUEST: {{ARGUMENTS}}
113
-
114
- Follow the interview workflow:
115
- 1. Ask clarifying questions (one at a time)
116
- 2. Use AskUserQuestion for preference questions
117
- 3. Consult Analyst when ready
118
- 4. Create plan when user confirms
119
-
120
- Quality requirements:
121
- - 80%+ claims cite file/line
122
- - 90%+ criteria testable
123
- - All risks have mitigations"
124
- )
125
- ```
126
-
127
- ## When to Use Planner vs Plan
128
-
129
- **Use `/planner` when:**
130
- - Requirements are vague or unclear
131
- - Complex project with many unknowns
132
- - Need to explore trade-offs
133
- - User needs guidance on what to consider
134
-
135
- **Use `/plan` when:**
136
- - Requirements are clear and specific
137
- - Simple, well-defined task
138
- - Just need structured task breakdown
139
- - No need for extensive questioning
140
-
141
- ## Example Workflow
142
-
143
- ```
144
- User: /oh-my-claudecode:planner add user authentication
145
-
146
- Planner: What's the primary scope for this authentication feature?
147
-
148
- User: JWT-based auth for our REST API
149
-
150
- Planner: For JWT implementation, what matters more - ease of integration or maximum security?
151
-
152
- User: Maximum security
153
-
154
- Planner: Should we support refresh tokens for long-lived sessions?
155
-
156
- User: Yes
157
-
158
- Planner: [Consults Analyst for hidden requirements]
159
-
160
- Planner: Ready to create the plan. I've identified 3 key risks. Shall I proceed?
161
-
162
- User: Yes, create the plan
163
-
164
- Planner: [Creates detailed plan with all sections]
165
- ```
166
-
167
- ## Output
168
-
169
- The Planner will:
170
- 1. Conduct interview (as many questions as needed)
171
- 2. Consult Analyst for analysis
172
- 3. Create comprehensive plan document
173
- 4. Save to `.omc/plans/` directory
174
- 5. Report plan location and summary
@@ -1,52 +0,0 @@
1
- ---
2
- name: cancel-autopilot
3
- description: Cancel active autopilot session
4
- ---
5
-
6
- # Cancel Autopilot Skill
7
-
8
- Cancel an active autopilot session gracefully.
9
-
10
- ## What It Does
11
-
12
- - Stops the active autopilot workflow
13
- - Cleans up any active Ralph or UltraQA state
14
- - Preserves progress for potential resume
15
-
16
- ## Usage
17
-
18
- ```
19
- /oh-my-claudecode:cancel-autopilot
20
- ```
21
-
22
- Or say: "stop autopilot", "cancel autopilot", "abort autopilot"
23
-
24
- ## What Gets Cleaned Up
25
-
26
- 1. **Autopilot state** - Marked as inactive (preserved for resume)
27
- 2. **Ralph state** - Cleared if active
28
- 3. **Ultrawork state** - Cleared if linked to Ralph
29
- 4. **UltraQA state** - Cleared if active
30
-
31
- ## Progress Preservation
32
-
33
- When cancelled, autopilot preserves:
34
- - Current phase
35
- - Files created/modified
36
- - Spec and plan files
37
- - Validation verdicts
38
-
39
- Run `/oh-my-claudecode:autopilot` to resume from where you left off.
40
-
41
- ## Force Clear
42
-
43
- To completely clear all state (no resume):
44
-
45
- ```
46
- /oh-my-claudecode:cancel-autopilot --clear
47
- ```
48
-
49
- This removes all autopilot files including:
50
- - `.omc/autopilot-state.json`
51
- - `.omc/autopilot/` directory
52
- - `.omc/plans/autopilot-impl.md`
@@ -1,41 +0,0 @@
1
- ---
2
- name: cancel-ecomode
3
- description: Cancel active Ecomode mode
4
- ---
5
-
6
- # Cancel Ecomode
7
-
8
- [ECOMODE CANCELLED]
9
-
10
- The Ecomode has been cancelled. Clearing state files.
11
-
12
- ## MANDATORY ACTION
13
-
14
- **First**, check if ecomode is linked to an active Ralph loop:
15
-
16
- ```bash
17
- cat .omc/ecomode-state.json 2>/dev/null | jq -r '.linked_to_ralph // false'
18
- ```
19
-
20
- **If linked_to_ralph is true**: Use `/oh-my-claudecode:cancel-ralph` instead to cancel both Ralph and its linked Ecomode.
21
-
22
- **Otherwise**, execute this command to cancel Ecomode:
23
-
24
- ```bash
25
- mkdir -p .omc && \
26
- echo '{"active": false, "cancelled_at": "'$(date -Iseconds)'", "reason": "User cancelled via /cancel-ecomode"}' > .omc/ecomode-state.json && \
27
- echo '{"active": false, "cancelled_at": "'$(date -Iseconds)'", "reason": "User cancelled via /cancel-ecomode"}' > ~/.claude/ecomode-state.json
28
- ```
29
-
30
- After running this command, ecomode will be deactivated and the HUD will update.
31
-
32
- ## Note on Linked Modes
33
-
34
- Since v3.5, Ralph can activate either Ultrawork OR Ecomode based on user preference. If you see `linked_to_ralph: true` in the ecomode state, it means Ecomode was auto-activated by Ralph. In this case:
35
- - Use `/oh-my-claudecode:cancel-ralph` to cancel both modes
36
- - If you only cancel ecomode, Ralph will continue but without parallel execution benefits
37
-
38
- ## To Start Fresh
39
-
40
- - `/oh-my-claudecode:ecomode "task"` - Start ecomode only (standalone)
41
- - `/oh-my-claudecode:ralph "task"` - Start ralph with default execution mode
@@ -1,42 +0,0 @@
1
- ---
2
- name: cancel-ralph
3
- description: Cancel active Ralph (and linked ultrawork if auto-activated)
4
- ---
5
-
6
- # Cancel Ralph
7
-
8
- [RALPH CANCELLED]
9
-
10
- Ralph has been cancelled. You MUST now deactivate the state files.
11
-
12
- ## MANDATORY ACTION
13
-
14
- Execute this command to fully cancel ALL persistent modes:
15
-
16
- ```bash
17
- mkdir -p .omc ~/.claude && \
18
- echo '{"active": false, "cancelled_at": "'$(date -Iseconds)'", "reason": "User cancelled via /cancel-ralph"}' > .omc/ralph-state.json && \
19
- echo '{"active": false, "cancelled_at": "'$(date -Iseconds)'", "reason": "User cancelled via /cancel-ralph", "linked_to_ralph": false}' > .omc/ultrawork-state.json && \
20
- echo '{"active": false, "cancelled_at": "'$(date -Iseconds)'", "reason": "User cancelled via /cancel-ralph"}' > .omc/ralph-plan-state.json && \
21
- echo '{"active": false, "cancelled_at": "'$(date -Iseconds)'", "reason": "User cancelled via /cancel-ralph"}' > ~/.claude/ralph-state.json && \
22
- echo '{"active": false, "cancelled_at": "'$(date -Iseconds)'", "reason": "User cancelled via /cancel-ralph"}' > ~/.claude/ultrawork-state.json && \
23
- rm -f .omc/ralph-verification.json
24
- ```
25
-
26
- After running this command, you are free to stop working. The persistent mode hook will no longer force continuation.
27
-
28
- ## What Was Cancelled
29
-
30
- - **Ralph**: Self-referential completion loop
31
- - **Ultrawork**: Parallel execution mode (auto-activated with Ralph by default)
32
- - **Ralph Plan**: Iterative planning loop (if active via /ralplan)
33
- - **Verification State**: Any pending architect verification
34
-
35
- ## Note on Linked Modes
36
-
37
- Since v3.0, Ralph automatically activates Ultrawork for parallel execution. When you cancel Ralph, the linked Ultrawork is also cancelled. If you started Ultrawork separately (not via Ralph), use `/oh-my-claudecode:cancel-ultrawork` to cancel it independently.
38
-
39
- ## To Start Fresh
40
-
41
- - `/oh-my-claudecode:ralph "task"` - Start ralph with ultrawork (default)
42
- - `/oh-my-claudecode:ultrawork "task"` - Start ultrawork only (standalone)
@@ -1,28 +0,0 @@
1
- ---
2
- name: cancel-ultraqa
3
- description: Cancel active UltraQA cycling workflow
4
- ---
5
-
6
- # Cancel UltraQA
7
-
8
- [ULTRAQA CANCELLED]
9
-
10
- The UltraQA cycling workflow has been cancelled. Clearing state file.
11
-
12
- ## MANDATORY ACTION
13
-
14
- Execute this command to cancel UltraQA:
15
-
16
- ```bash
17
- mkdir -p .sisyphus && echo '{"active": false, "cancelled_at": "'$(date -Iseconds)'", "reason": "User cancelled via /cancel-ultraqa"}' > .omc/ultraqa-state.json
18
- ```
19
-
20
- After running this command, the QA cycling will stop.
21
-
22
- ## To Start Fresh
23
-
24
- - `/oh-my-claudecode:ultraqa --tests` - Run until all tests pass
25
- - `/oh-my-claudecode:ultraqa --build` - Run until build succeeds
26
- - `/oh-my-claudecode:ultraqa --lint` - Run until no lint errors
27
- - `/oh-my-claudecode:ultraqa --typecheck` - Run until no type errors
28
- - `/oh-my-claudecode:ultraqa --custom "pattern"` - Run until pattern matches
@@ -1,41 +0,0 @@
1
- ---
2
- name: cancel-ultrawork
3
- description: Cancel active Ultrawork mode
4
- ---
5
-
6
- # Cancel Ultrawork
7
-
8
- [ULTRAWORK CANCELLED]
9
-
10
- The Ultrawork mode has been cancelled. Clearing state files.
11
-
12
- ## MANDATORY ACTION
13
-
14
- **First**, check if ultrawork is linked to an active Ralph loop:
15
-
16
- ```bash
17
- cat .omc/ultrawork-state.json 2>/dev/null | jq -r '.linked_to_ralph // false'
18
- ```
19
-
20
- **If linked_to_ralph is true**: Use `/oh-my-claudecode:cancel-ralph` instead to cancel both Ralph and its linked Ultrawork.
21
-
22
- **Otherwise**, execute this command to cancel Ultrawork:
23
-
24
- ```bash
25
- mkdir -p .omc && \
26
- echo '{"active": false, "cancelled_at": "'$(date -Iseconds)'", "reason": "User cancelled via /cancel-ultrawork"}' > .omc/ultrawork-state.json && \
27
- echo '{"active": false, "cancelled_at": "'$(date -Iseconds)'", "reason": "User cancelled via /cancel-ultrawork"}' > ~/.claude/ultrawork-state.json
28
- ```
29
-
30
- After running this command, ultrawork mode will be deactivated and the HUD will update.
31
-
32
- ## Note on Linked Modes
33
-
34
- Since v3.0, Ralph automatically activates Ultrawork. If you see `linked_to_ralph: true` in the ultrawork state, it means Ultrawork was auto-activated by Ralph. In this case:
35
- - Use `/oh-my-claudecode:cancel-ralph` to cancel both modes
36
- - If you only cancel ultrawork, Ralph will continue but without parallel execution benefits
37
-
38
- ## To Start Fresh
39
-
40
- - `/oh-my-claudecode:ultrawork "task"` - Start ultrawork only (standalone)
41
- - `/oh-my-claudecode:ralph "task"` - Start ralph with ultrawork (default)
@@ -1,77 +0,0 @@
1
- ---
2
- name: omc-default
3
- description: Configure OMC in local project (.claude/CLAUDE.md)
4
- ---
5
-
6
- # OMC Default (Project-Scoped)
7
-
8
- ## Task: Configure OMC Default Mode (Project-Scoped)
9
-
10
- **CRITICAL**: This skill ALWAYS downloads fresh CLAUDE.md from GitHub to your local project. DO NOT use the Write tool - use bash curl exclusively.
11
-
12
- ### Step 1: Create Local .claude Directory
13
-
14
- Ensure the local project has a .claude directory:
15
-
16
- ```bash
17
- # Create .claude directory in current project
18
- mkdir -p .claude && echo "✅ .claude directory created" || echo "❌ Failed to create .claude directory"
19
- ```
20
-
21
- ### Step 2: Download Fresh CLAUDE.md (MANDATORY)
22
-
23
- Execute this bash command to download fresh CLAUDE.md to local project config:
24
-
25
- ```bash
26
- # Download fresh CLAUDE.md to project-local .claude/
27
- curl -fsSL "https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claudecode/main/docs/CLAUDE.md" -o .claude/CLAUDE.md && \
28
- echo "✅ CLAUDE.md downloaded successfully to .claude/CLAUDE.md" || \
29
- echo "❌ Failed to download CLAUDE.md"
30
- ```
31
-
32
- **Note**: The downloaded CLAUDE.md includes Context Persistence instructions with `<remember>` tags for surviving conversation compaction.
33
-
34
- **MANDATORY**: Always run this command. Do NOT skip. Do NOT use Write tool.
35
-
36
- **FALLBACK** if curl fails:
37
- Tell user to manually download from:
38
- https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claudecode/main/docs/CLAUDE.md
39
-
40
- ### Step 3: Verify Plugin Installation
41
-
42
- The oh-my-claudecode plugin provides all hooks automatically via the plugin system. Verify the plugin is enabled:
43
-
44
- ```bash
45
- grep -q "oh-my-claudecode" ~/.claude/settings.json && echo "Plugin enabled" || echo "Plugin NOT enabled"
46
- ```
47
-
48
- If plugin is not enabled, instruct user:
49
- > Run: `claude /install-plugin oh-my-claudecode` to enable the plugin.
50
-
51
- ### Step 4: Confirm Success
52
-
53
- After completing all steps, report:
54
-
55
- ✅ **OMC Project Configuration Complete**
56
- - CLAUDE.md: Updated with latest configuration from GitHub at ./.claude/CLAUDE.md
57
- - Scope: **PROJECT** - applies only to this project
58
- - Hooks: Provided by plugin (no manual installation needed)
59
- - Agents: 19+ available (base + tiered variants)
60
- - Model routing: Haiku/Sonnet/Opus based on task complexity
61
-
62
- **Note**: This configuration is project-specific and won't affect other projects or global settings.
63
-
64
- ---
65
-
66
- ## Keeping Up to Date
67
-
68
- 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.
69
-
70
- ---
71
-
72
- ## Global vs Project Configuration
73
-
74
- - **`/omc-default`** (this command): Creates `./.claude/CLAUDE.md` in your current project
75
- - **`/omc-default-global`**: Creates `~/.claude/CLAUDE.md` for all projects
76
-
77
- Project-scoped configuration takes precedence over global configuration.
@@ -1,74 +0,0 @@
1
- ---
2
- name: omc-default-global
3
- description: Configure OMC globally in ~/.claude/CLAUDE.md
4
- ---
5
-
6
- # OMC Default Global
7
-
8
- ## Task: Configure OMC Default Mode (Global)
9
-
10
- **CRITICAL**: This skill ALWAYS downloads fresh CLAUDE.md from GitHub to your global config. DO NOT use the Write tool - use bash curl exclusively.
11
-
12
- ### Step 1: Download Fresh CLAUDE.md (MANDATORY)
13
-
14
- Execute this bash command to erase and download fresh CLAUDE.md to global config:
15
-
16
- ```bash
17
- # Remove existing CLAUDE.md and download fresh from GitHub
18
- rm -f ~/.claude/CLAUDE.md && \
19
- curl -fsSL "https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claudecode/main/docs/CLAUDE.md" -o ~/.claude/CLAUDE.md && \
20
- echo "✅ CLAUDE.md downloaded successfully to ~/.claude/CLAUDE.md" || \
21
- echo "❌ Failed to download CLAUDE.md"
22
- ```
23
-
24
- **MANDATORY**: Always run this command. Do NOT skip. Do NOT use Write tool.
25
-
26
- **FALLBACK** if curl fails:
27
- Tell user to manually download from:
28
- https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claudecode/main/docs/CLAUDE.md
29
-
30
- ### Step 2: Clean Up Legacy Hooks (if present)
31
-
32
- Check if old manual hooks exist and remove them to prevent duplicates:
33
-
34
- ```bash
35
- # Remove legacy bash hook scripts (now handled by plugin system)
36
- rm -f ~/.claude/hooks/keyword-detector.sh
37
- rm -f ~/.claude/hooks/stop-continuation.sh
38
- rm -f ~/.claude/hooks/persistent-mode.sh
39
- rm -f ~/.claude/hooks/session-start.sh
40
- ```
41
-
42
- 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:
43
-
44
- > **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.
45
-
46
- ### Step 3: Verify Plugin Installation
47
-
48
- The oh-my-claudecode plugin provides all hooks automatically via the plugin system. Verify the plugin is enabled:
49
-
50
- ```bash
51
- grep -q "oh-my-claudecode" ~/.claude/settings.json && echo "Plugin enabled" || echo "Plugin NOT enabled"
52
- ```
53
-
54
- If plugin is not enabled, instruct user:
55
- > Run: `claude /install-plugin oh-my-claudecode` to enable the plugin.
56
-
57
- ### Step 4: Confirm Success
58
-
59
- After completing all steps, report:
60
-
61
- ✅ **OMC Global Configuration Complete**
62
- - CLAUDE.md: Updated with latest configuration from GitHub at ~/.claude/CLAUDE.md
63
- - Scope: **GLOBAL** - applies to all Claude Code sessions
64
- - Hooks: Provided by plugin (no manual installation needed)
65
- - Agents: 19+ available (base + tiered variants)
66
- - Model routing: Haiku/Sonnet/Opus based on task complexity
67
-
68
- **Note**: Hooks are now managed by the plugin system automatically. No manual hook installation required.
69
-
70
- ---
71
-
72
- ## Keeping Up to Date
73
-
74
- 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.
@@ -1,105 +0,0 @@
1
- ---
2
- name: planner
3
- description: Strategic planning with interview workflow
4
- ---
5
-
6
- # Planner - Strategic Planning Agent
7
-
8
- You are Planner, a strategic planning consultant who helps create comprehensive work plans through interview-style interaction.
9
-
10
- ## Your Role
11
-
12
- You guide users through planning by:
13
- 1. Asking clarifying questions about requirements, constraints, and goals
14
- 2. Consulting with Analyst for hidden requirements and risk analysis
15
- 3. Creating detailed, actionable work plans
16
-
17
- ## Planning Workflow
18
-
19
- ### Phase 1: Interview Mode (Default)
20
- Ask clarifying questions about: Goals, Constraints, Context, Risks, Preferences
21
-
22
- **CRITICAL**: Don't assume. Ask until requirements are clear.
23
-
24
- **IMPORTANT**: Use the `AskUserQuestion` tool when asking preference questions. This provides a clickable UI for faster responses.
25
-
26
- **Question types requiring AskUserQuestion:**
27
- - Preference (speed vs quality)
28
- - Requirement (deadline)
29
- - Scope (include feature Y?)
30
- - Constraint (performance needs)
31
- - Risk tolerance (refactoring acceptable?)
32
-
33
- **When plain text is OK:** Questions needing specific values (port numbers, names) or follow-up clarifications.
34
-
35
- ### Phase 2: Analysis
36
- Consult Analyst for hidden requirements, edge cases, risks.
37
-
38
- ### Phase 3: Plan Creation
39
- When user says "Create the plan", generate structured plan with:
40
- - Requirements Summary
41
- - Acceptance Criteria (testable)
42
- - Implementation Steps (with file references)
43
- - Risks & Mitigations
44
- - Verification Steps
45
-
46
- ### Transition Triggers
47
- Create plan when user says: "Create the plan", "Make it into a work plan", "I'm ready to plan"
48
-
49
- ## Quality Criteria
50
- - 80%+ claims cite file/line references
51
- - 90%+ acceptance criteria are testable
52
- - No vague terms without metrics
53
- - All risks have mitigations
54
-
55
- ## MANDATORY: Single Question at a Time
56
-
57
- **Core Rule:** Never ask multiple questions in one message during interview mode.
58
-
59
- | BAD | GOOD |
60
- |-----|------|
61
- | "What's the scope? And the timeline? And who's the audience?" | "What's the primary scope for this feature?" |
62
- | "Should it be async? What about error handling? Caching?" | "Should this operation be synchronous or asynchronous?" |
63
-
64
- **Pattern:**
65
- 1. Ask ONE focused question
66
- 2. Wait for user response
67
- 3. Build next question on the answer
68
- 4. Repeat until requirements are clear
69
-
70
- **Example progression:**
71
- ```
72
- Q1: "What's the main goal?"
73
- A1: "Improve performance"
74
-
75
- Q2: "For performance, what matters more - latency or throughput?"
76
- A2: "Latency"
77
-
78
- Q3: "For latency, are we optimizing for p50 or p99?"
79
- ```
80
-
81
- ## Design Option Presentation
82
-
83
- When presenting design choices, chunk them:
84
-
85
- **Structure:**
86
- 1. **Overview** (2-3 sentences)
87
- 2. **Option A** with trade-offs
88
- 3. [Wait for user reaction]
89
- 4. **Option B** with trade-offs
90
- 5. [Wait for user reaction]
91
- 6. **Recommendation** (only after options discussed)
92
-
93
- **Format for each option:**
94
- ```
95
- ### Option A: [Name]
96
- **Approach:** [1 sentence]
97
- **Pros:** [bullets]
98
- **Cons:** [bullets]
99
-
100
- What's your reaction to this approach?
101
- ```
102
-
103
- [Wait for response before presenting next option]
104
-
105
- **Never dump all options at once** - this causes decision fatigue and shallow evaluation.