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.
- package/commands/doctor.md +1 -1
- package/commands/ecomode.md +1 -2
- package/commands/help.md +1 -1
- package/commands/learn-about-omc.md +5 -0
- package/commands/omc-setup.md +4 -4
- package/commands/ralplan.md +1 -1
- package/commands/research.md +2 -2
- package/commands/ultraqa.md +1 -1
- package/dist/__tests__/analytics/transcript-token-extractor.test.js +4 -2
- package/dist/__tests__/analytics/transcript-token-extractor.test.js.map +1 -1
- package/dist/__tests__/delegation-enforcer-integration.test.d.ts +4 -0
- package/dist/__tests__/delegation-enforcer-integration.test.d.ts.map +1 -1
- package/dist/__tests__/delegation-enforcer-integration.test.js +5 -1
- package/dist/__tests__/delegation-enforcer-integration.test.js.map +1 -1
- package/dist/__tests__/skills.test.js +17 -19
- package/dist/__tests__/skills.test.js.map +1 -1
- package/dist/hooks/auto-slash-command/constants.d.ts.map +1 -1
- package/dist/hooks/auto-slash-command/constants.js +1 -4
- package/dist/hooks/auto-slash-command/constants.js.map +1 -1
- package/dist/hooks/ralph/loop.js +1 -1
- package/dist/hooks/ralph/loop.js.map +1 -1
- package/dist/hooks/ultraqa/index.js +1 -1
- package/dist/hooks/ultraqa/index.js.map +1 -1
- package/docs/CLAUDE.md +9 -16
- package/docs/FULL-README.md +49 -56
- package/docs/MIGRATION.md +96 -1
- package/package.json +1 -1
- package/scripts/install.sh +8 -217
- package/scripts/uninstall.sh +0 -4
- package/skills/autopilot/SKILL.md +1 -1
- package/skills/cancel/SKILL.md +35 -0
- package/skills/doctor/SKILL.md +1 -1
- package/skills/help/SKILL.md +2 -2
- package/skills/learn-about-omc/SKILL.md +128 -0
- package/skills/mcp-setup/SKILL.md +63 -75
- package/skills/omc-setup/SKILL.md +4 -4
- package/skills/ralplan/SKILL.md +19 -250
- package/skills/research/SKILL.md +2 -2
- package/skills/ultrapilot/SKILL.md +1 -1
- package/skills/ultraqa/SKILL.md +1 -1
- package/commands/cancel-autopilot.md +0 -35
- package/commands/cancel-ecomode.md +0 -71
- package/commands/cancel-ralph.md +0 -41
- package/commands/cancel-ultraqa.md +0 -27
- package/commands/cancel-ultrawork.md +0 -40
- package/commands/planner.md +0 -174
- package/skills/cancel-autopilot/SKILL.md +0 -52
- package/skills/cancel-ecomode/SKILL.md +0 -41
- package/skills/cancel-ralph/SKILL.md +0 -42
- package/skills/cancel-ultraqa/SKILL.md +0 -28
- package/skills/cancel-ultrawork/SKILL.md +0 -41
- package/skills/omc-default/SKILL.md +0 -77
- package/skills/omc-default-global/SKILL.md +0 -74
- package/skills/planner/SKILL.md +0 -105
package/commands/planner.md
DELETED
|
@@ -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.
|
package/skills/planner/SKILL.md
DELETED
|
@@ -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.
|