oh-my-claude-sisyphus 3.5.6 → 3.5.7
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/README.md +58 -343
- package/commands/omc-setup.md +51 -0
- package/dist/__tests__/analytics/tokscale-adapter.test.d.ts +2 -0
- package/dist/__tests__/analytics/tokscale-adapter.test.d.ts.map +1 -0
- package/dist/__tests__/analytics/tokscale-adapter.test.js +79 -0
- package/dist/__tests__/analytics/tokscale-adapter.test.js.map +1 -0
- package/dist/analytics/cost-estimator.d.ts +14 -0
- package/dist/analytics/cost-estimator.d.ts.map +1 -1
- package/dist/analytics/cost-estimator.js +65 -0
- package/dist/analytics/cost-estimator.js.map +1 -1
- package/dist/analytics/index.d.ts +1 -0
- package/dist/analytics/index.d.ts.map +1 -1
- package/dist/analytics/index.js +4 -0
- package/dist/analytics/index.js.map +1 -1
- package/dist/analytics/query-engine.d.ts +3 -0
- package/dist/analytics/query-engine.d.ts.map +1 -1
- package/dist/analytics/query-engine.js +87 -0
- package/dist/analytics/query-engine.js.map +1 -1
- package/dist/analytics/token-tracker.d.ts +3 -0
- package/dist/analytics/token-tracker.d.ts.map +1 -1
- package/dist/analytics/token-tracker.js +89 -0
- package/dist/analytics/token-tracker.js.map +1 -1
- package/dist/analytics/tokscale-adapter.d.ts +71 -0
- package/dist/analytics/tokscale-adapter.d.ts.map +1 -0
- package/dist/analytics/tokscale-adapter.js +223 -0
- package/dist/analytics/tokscale-adapter.js.map +1 -0
- package/dist/analytics/types.d.ts +17 -0
- package/dist/analytics/types.d.ts.map +1 -1
- package/dist/analytics/types.js +5 -0
- package/dist/analytics/types.js.map +1 -1
- package/dist/cli/analytics.js +35 -0
- package/dist/cli/analytics.js.map +1 -1
- package/dist/cli/commands/agents.d.ts.map +1 -1
- package/dist/cli/commands/agents.js +4 -2
- package/dist/cli/commands/agents.js.map +1 -1
- package/dist/cli/commands/stats.d.ts.map +1 -1
- package/dist/cli/commands/stats.js +6 -1
- package/dist/cli/commands/stats.js.map +1 -1
- package/dist/cli/index.js +95 -35
- package/dist/cli/index.js.map +1 -1
- package/dist/cli/utils/tokscale-launcher.d.ts +18 -0
- package/dist/cli/utils/tokscale-launcher.d.ts.map +1 -0
- package/dist/cli/utils/tokscale-launcher.js +64 -0
- package/dist/cli/utils/tokscale-launcher.js.map +1 -0
- package/dist/features/auto-update.js +5 -5
- package/dist/features/auto-update.js.map +1 -1
- package/dist/hud/types.d.ts +6 -2
- package/dist/hud/types.d.ts.map +1 -1
- package/dist/hud/types.js.map +1 -1
- package/dist/hud/usage-api.d.ts.map +1 -1
- package/dist/hud/usage-api.js +13 -1
- package/dist/hud/usage-api.js.map +1 -1
- package/docs/ARCHITECTURE.md +80 -397
- package/docs/FEATURES.md +396 -1981
- package/docs/MIGRATION.md +4 -4
- package/docs/REFERENCE.md +545 -0
- package/docs/SYNC-SYSTEM.md +6 -6
- package/package.json +2 -1
- package/scripts/sync-metadata.ts +2 -2
- package/skills/omc-setup/SKILL.md +51 -0
- package/docs/FULL-README.md +0 -1001
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"usage-api.js","sourceRoot":"","sources":["../../src/hud/usage-api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,sBAAsB;AACtB,MAAM,oBAAoB,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,sCAAsC;AAC9E,MAAM,oBAAoB,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,0BAA0B;AAClE,MAAM,cAAc,GAAG,KAAK,CAAC;
|
|
1
|
+
{"version":3,"file":"usage-api.js","sourceRoot":"","sources":["../../src/hud/usage-api.ts"],"names":[],"mappings":"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"}
|
package/docs/ARCHITECTURE.md
CHANGED
|
@@ -1,261 +1,10 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Architecture
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
---
|
|
3
|
+
> How oh-my-claudecode orchestrates multi-agent workflows.
|
|
6
4
|
|
|
7
5
|
## Overview
|
|
8
6
|
|
|
9
|
-
|
|
10
|
-
|--------|----------|-------------|
|
|
11
|
-
| Master Agent | **Swappable** | **Fixed** |
|
|
12
|
-
| Sub Agents | Via Task tool | Via Task tool |
|
|
13
|
-
| Routing | Agent switching | Skill activation |
|
|
14
|
-
| Flexibility | High (any agent as master) | High (via skill composition) |
|
|
15
|
-
|
|
16
|
-
---
|
|
17
|
-
|
|
18
|
-
## OpenCode: Swappable Master Agent
|
|
19
|
-
|
|
20
|
-
### How It Works
|
|
21
|
-
|
|
22
|
-
In OpenCode (oh-my-opencode), the master agent can be dynamically swapped based on task requirements:
|
|
23
|
-
|
|
24
|
-
```
|
|
25
|
-
┌─────────────────────────────────────────────────────────────┐
|
|
26
|
-
│ OPENCODE RUNTIME │
|
|
27
|
-
└─────────────────────────────────────────────────────────────┘
|
|
28
|
-
│
|
|
29
|
-
┌───────────────┼───────────────┐
|
|
30
|
-
│ │ │
|
|
31
|
-
▼ ▼ ▼
|
|
32
|
-
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
|
|
33
|
-
│ DEFAULT │ │ ARCHITECT │ │ PLANNER │
|
|
34
|
-
│ (Default) │ │ (Debug) │ │ (Planning) │
|
|
35
|
-
│ │ │ │ │ │
|
|
36
|
-
│ Can become │ │ Can become │ │ Can become │
|
|
37
|
-
│ MASTER │ │ MASTER │ │ MASTER │
|
|
38
|
-
└─────────────┘ └─────────────┘ └─────────────┘
|
|
39
|
-
│ │ │
|
|
40
|
-
└───────────────┼───────────────┘
|
|
41
|
-
│
|
|
42
|
-
▼
|
|
43
|
-
┌─────────────────┐
|
|
44
|
-
│ SUB-AGENTS │
|
|
45
|
-
│ (Delegated) │
|
|
46
|
-
└─────────────────┘
|
|
47
|
-
```
|
|
48
|
-
|
|
49
|
-
### Agent Switching Flow
|
|
50
|
-
|
|
51
|
-
```typescript
|
|
52
|
-
// OpenCode pseudo-code
|
|
53
|
-
class AgentOrchestrator {
|
|
54
|
-
private masterAgent: Agent;
|
|
55
|
-
|
|
56
|
-
// Can swap master at runtime
|
|
57
|
-
switchMaster(agentType: 'default' | 'architect' | 'planner') {
|
|
58
|
-
this.masterAgent = AgentFactory.create(agentType);
|
|
59
|
-
}
|
|
60
|
-
|
|
61
|
-
// Master delegates to sub-agents
|
|
62
|
-
async execute(task: string) {
|
|
63
|
-
return this.masterAgent.run(task, {
|
|
64
|
-
subAgents: this.availableSubAgents
|
|
65
|
-
});
|
|
66
|
-
}
|
|
67
|
-
}
|
|
68
|
-
|
|
69
|
-
// Usage
|
|
70
|
-
orchestrator.switchMaster('planner'); // Planning mode
|
|
71
|
-
await orchestrator.execute('Design auth system');
|
|
72
|
-
|
|
73
|
-
orchestrator.switchMaster('default'); // Implementation mode
|
|
74
|
-
await orchestrator.execute('Implement the plan');
|
|
75
|
-
```
|
|
76
|
-
|
|
77
|
-
### Pros
|
|
78
|
-
- Direct control over which agent leads
|
|
79
|
-
- Clean separation between master behaviors
|
|
80
|
-
- Easy to add new master agent types
|
|
81
|
-
|
|
82
|
-
### Cons
|
|
83
|
-
- Requires runtime agent management
|
|
84
|
-
- Context can be lost during switches
|
|
85
|
-
- More complex state management
|
|
86
|
-
|
|
87
|
-
---
|
|
88
|
-
|
|
89
|
-
## Claude Code: Fixed Master with Skills
|
|
90
|
-
|
|
91
|
-
### The Constraint
|
|
92
|
-
|
|
93
|
-
Claude Code has a **fixed master agent** - you cannot swap which agent is the "main" one. The conversation always runs through the same Claude instance.
|
|
94
|
-
|
|
95
|
-
```
|
|
96
|
-
┌─────────────────────────────────────────────────────────────┐
|
|
97
|
-
│ CLAUDE CODE RUNTIME │
|
|
98
|
-
└─────────────────────────────────────────────────────────────┘
|
|
99
|
-
│
|
|
100
|
-
▼
|
|
101
|
-
┌─────────────────┐
|
|
102
|
-
│ CLAUDE MASTER │ ← FIXED, cannot swap
|
|
103
|
-
│ (Always On) │
|
|
104
|
-
└────────┬────────┘
|
|
105
|
-
│
|
|
106
|
-
┌──────────────┼──────────────┐
|
|
107
|
-
│ │ │
|
|
108
|
-
▼ ▼ ▼
|
|
109
|
-
┌───────────┐ ┌───────────┐ ┌───────────┐
|
|
110
|
-
│ architect │ │ researcher│ │ explore │
|
|
111
|
-
│ (Opus) │ │ (Sonnet) │ │ (Haiku) │
|
|
112
|
-
└───────────┘ └───────────┘ └───────────┘
|
|
113
|
-
↑ ↑ ↑
|
|
114
|
-
└──────────────┼──────────────┘
|
|
115
|
-
│
|
|
116
|
-
Only as SUB-agents
|
|
117
|
-
(via Task tool)
|
|
118
|
-
```
|
|
119
|
-
|
|
120
|
-
### The Solution: Skill-Based Routing
|
|
121
|
-
|
|
122
|
-
Instead of swapping the master agent, we **inject behaviors** into the fixed master through Skills:
|
|
123
|
-
|
|
124
|
-
```
|
|
125
|
-
┌─────────────────────────────────────────────────────────────┐
|
|
126
|
-
│ CLAUDE CODE + SKILLS │
|
|
127
|
-
└─────────────────────────────────────────────────────────────┘
|
|
128
|
-
│
|
|
129
|
-
▼
|
|
130
|
-
┌─────────────────┐
|
|
131
|
-
│ CLAUDE MASTER │
|
|
132
|
-
│ │
|
|
133
|
-
│ ┌───────────┐ │
|
|
134
|
-
│ │ SKILL │ │ ← Injected behavior
|
|
135
|
-
│ │ LAYER │ │
|
|
136
|
-
│ └───────────┘ │
|
|
137
|
-
└────────┬────────┘
|
|
138
|
-
│
|
|
139
|
-
┌──────────────┼──────────────┐
|
|
140
|
-
▼ ▼ ▼
|
|
141
|
-
Sub-agents Sub-agents Sub-agents
|
|
142
|
-
```
|
|
143
|
-
|
|
144
|
-
### How Skills Work
|
|
145
|
-
|
|
146
|
-
Skills are **behavior injections** that modify how the master agent operates:
|
|
147
|
-
|
|
148
|
-
```markdown
|
|
149
|
-
# When user says "plan the auth system"
|
|
150
|
-
|
|
151
|
-
1. CLAUDE.md contains routing rules
|
|
152
|
-
2. Claude detects "plan" → planning task
|
|
153
|
-
3. Claude invokes Skill(skill: "planner")
|
|
154
|
-
4. Planner skill template is injected
|
|
155
|
-
5. Claude now BEHAVES like Planner
|
|
156
|
-
6. But it's still the same master agent
|
|
157
|
-
```
|
|
158
|
-
|
|
159
|
-
---
|
|
160
|
-
|
|
161
|
-
## The Elegant Solution: Intelligent Skill Activation
|
|
162
|
-
|
|
163
|
-
### Skill Layers
|
|
164
|
-
|
|
165
|
-
We solved the "can't swap master" limitation by creating **composable skill layers**:
|
|
166
|
-
|
|
167
|
-
```
|
|
168
|
-
┌─────────────────────────────────────────────────────────────┐
|
|
169
|
-
│ SKILL COMPOSITION │
|
|
170
|
-
└─────────────────────────────────────────────────────────────┘
|
|
171
|
-
|
|
172
|
-
┌─────────────────────────────────────────────────────────┐
|
|
173
|
-
│ GUARANTEE LAYER (optional) │
|
|
174
|
-
│ ┌─────────────┐ │
|
|
175
|
-
│ │ ralph │ "Cannot stop until verified done" │
|
|
176
|
-
│ └─────────────┘ │
|
|
177
|
-
└─────────────────────────────────────────────────────────┘
|
|
178
|
-
│
|
|
179
|
-
▼
|
|
180
|
-
┌─────────────────────────────────────────────────────────┐
|
|
181
|
-
│ ENHANCEMENT LAYER (0-N skills) │
|
|
182
|
-
│ ┌───────────┐ ┌───────────┐ ┌─────────────────┐ │
|
|
183
|
-
│ │ ultrawork │ │git-master │ │ frontend-ui-ux │ │
|
|
184
|
-
│ │ (parallel)│ │ (commits) │ │ (design) │ │
|
|
185
|
-
│ └───────────┘ └───────────┘ └─────────────────┘ │
|
|
186
|
-
└─────────────────────────────────────────────────────────┘
|
|
187
|
-
│
|
|
188
|
-
▼
|
|
189
|
-
┌─────────────────────────────────────────────────────────┐
|
|
190
|
-
│ EXECUTION LAYER (pick one primary) │
|
|
191
|
-
│ ┌───────────┐ ┌─────────────┐ ┌────────────┐ │
|
|
192
|
-
│ │ default │ │ orchestrator│ │ planner │ │
|
|
193
|
-
│ │ (build) │ │ (coordinate)│ │ (plan) │ │
|
|
194
|
-
│ └───────────┘ └─────────────┘ └────────────┘ │
|
|
195
|
-
└─────────────────────────────────────────────────────────┘
|
|
196
|
-
```
|
|
197
|
-
|
|
198
|
-
### Composition Formula
|
|
199
|
-
|
|
200
|
-
```
|
|
201
|
-
[Execution Skill] + [0-N Enhancement Skills] + [Optional Guarantee]
|
|
202
|
-
```
|
|
203
|
-
|
|
204
|
-
### Examples
|
|
205
|
-
|
|
206
|
-
```
|
|
207
|
-
Task: "Add dark mode with proper commits"
|
|
208
|
-
Skills: default + frontend-ui-ux + git-master
|
|
209
|
-
|
|
210
|
-
Task: "ultrawork: refactor entire API"
|
|
211
|
-
Skills: ultrawork + default + git-master
|
|
212
|
-
|
|
213
|
-
Task: "Plan auth, then implement completely"
|
|
214
|
-
Skills: planner → default + ralph (transition)
|
|
215
|
-
|
|
216
|
-
Task: "Fix bug, don't stop until done"
|
|
217
|
-
Skills: default + ralph
|
|
218
|
-
```
|
|
219
|
-
|
|
220
|
-
---
|
|
221
|
-
|
|
222
|
-
## Comparison: Agent Swap vs Skill Activation
|
|
223
|
-
|
|
224
|
-
### Scenario: Complex Project with Planning → Implementation
|
|
225
|
-
|
|
226
|
-
**OpenCode Approach (Agent Swap):**
|
|
227
|
-
```
|
|
228
|
-
1. User: "Plan the authentication system"
|
|
229
|
-
2. System: Switch master to Planner
|
|
230
|
-
3. Planner: Creates comprehensive plan
|
|
231
|
-
4. User: "Now implement it"
|
|
232
|
-
5. System: Switch master to Default ← Context may be lost
|
|
233
|
-
6. Default: Implements (needs to re-read plan)
|
|
234
|
-
```
|
|
235
|
-
|
|
236
|
-
**Claude Code Approach (Skill Activation):**
|
|
237
|
-
```
|
|
238
|
-
1. User: "Plan the authentication system"
|
|
239
|
-
2. Claude: Activates planner skill
|
|
240
|
-
3. Claude (as Planner): Creates comprehensive plan
|
|
241
|
-
4. User: "Now implement it"
|
|
242
|
-
5. Claude: Transitions to default skill ← Same context!
|
|
243
|
-
6. Claude (as Default): Implements (already has plan in context)
|
|
244
|
-
```
|
|
245
|
-
|
|
246
|
-
### Why Skills Are More Elegant
|
|
247
|
-
|
|
248
|
-
| Aspect | Agent Swap | Skill Activation |
|
|
249
|
-
|--------|------------|------------------|
|
|
250
|
-
| Context | Lost on swap | Preserved |
|
|
251
|
-
| Transitions | Explicit, disruptive | Seamless, fluid |
|
|
252
|
-
| Composition | One master at a time | Multiple skills stack |
|
|
253
|
-
| State | Needs external tracking | In-conversation |
|
|
254
|
-
| User Experience | "Switch to X mode" | Natural language |
|
|
255
|
-
|
|
256
|
-
---
|
|
257
|
-
|
|
258
|
-
## Architecture Diagram
|
|
7
|
+
oh-my-claudecode enables Claude Code to orchestrate specialized agents through a skill-based routing system.
|
|
259
8
|
|
|
260
9
|
```
|
|
261
10
|
┌─────────────────────────────────────────────────────────────────────────┐
|
|
@@ -287,179 +36,113 @@ Skills: default + ralph
|
|
|
287
36
|
└─────────────────┘
|
|
288
37
|
```
|
|
289
38
|
|
|
290
|
-
|
|
39
|
+
## Core Concepts
|
|
291
40
|
|
|
292
|
-
|
|
41
|
+
### Skills
|
|
293
42
|
|
|
294
|
-
|
|
43
|
+
Skills are **behavior injections** that modify how the orchestrator operates. Instead of swapping agents, we inject capabilities through composable skills:
|
|
295
44
|
|
|
296
|
-
|
|
297
|
-
|
|
45
|
+
- **Execution Skills**: Primary task handlers (`default`, `planner`, `orchestrate`)
|
|
46
|
+
- **Enhancement Skills**: Additional capabilities (`ultrawork`, `git-master`, `frontend-ui-ux`)
|
|
47
|
+
- **Guarantee Skills**: Completion enforcement (`ralph`)
|
|
298
48
|
|
|
299
|
-
Skills
|
|
300
|
-
|
|
49
|
+
Skills can stack and compose:
|
|
50
|
+
```
|
|
51
|
+
Task: "ultrawork: refactor API with proper commits"
|
|
52
|
+
Skills: ultrawork + default + git-master
|
|
53
|
+
```
|
|
301
54
|
|
|
302
|
-
###
|
|
55
|
+
### Agents
|
|
303
56
|
|
|
304
|
-
|
|
57
|
+
32 specialized agents organized by complexity tier:
|
|
305
58
|
|
|
306
|
-
|
|
|
307
|
-
|
|
308
|
-
|
|
|
309
|
-
|
|
|
310
|
-
|
|
|
311
|
-
| UI/frontend work | `+ frontend-ui-ux` | Components, styling |
|
|
312
|
-
| Strategic planning | `planner` | Need plan first |
|
|
313
|
-
| Must complete | `+ ralph` | Completion critical |
|
|
59
|
+
| Tier | Model | Use For |
|
|
60
|
+
|------|-------|---------|
|
|
61
|
+
| LOW | Haiku | Quick lookups, simple operations |
|
|
62
|
+
| MEDIUM | Sonnet | Standard implementations |
|
|
63
|
+
| HIGH | Opus | Complex reasoning, architecture |
|
|
314
64
|
|
|
315
|
-
|
|
65
|
+
See [FEATURES.md](./FEATURES.md) for the complete agent roster.
|
|
316
66
|
|
|
317
|
-
|
|
318
|
-
- **DO** use your judgment
|
|
319
|
-
- **DO** combine skills when multiple apply
|
|
320
|
-
- **EXPLICIT** slash commands always take precedence
|
|
321
|
-
```
|
|
67
|
+
### Delegation
|
|
322
68
|
|
|
323
|
-
|
|
69
|
+
Work is delegated through the Task tool with intelligent model routing:
|
|
324
70
|
|
|
325
71
|
```typescript
|
|
326
|
-
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
// 2. Select skill combination
|
|
333
|
-
const skills = selectSkills(taskType);
|
|
334
|
-
// e.g., ['default', 'ultrawork', 'git-master']
|
|
335
|
-
|
|
336
|
-
// 3. Invoke skills (stacked)
|
|
337
|
-
for (const skill of skills) {
|
|
338
|
-
invoke(Skill, { skill }); // Skill tool
|
|
339
|
-
}
|
|
340
|
-
|
|
341
|
-
// 4. Execute with combined behaviors
|
|
342
|
-
executeTask(request);
|
|
343
|
-
}
|
|
72
|
+
Task(
|
|
73
|
+
subagent_type="oh-my-claudecode:executor",
|
|
74
|
+
model="sonnet",
|
|
75
|
+
prompt="Implement feature..."
|
|
76
|
+
)
|
|
344
77
|
```
|
|
345
78
|
|
|
346
|
-
|
|
79
|
+
Categories like `visual-engineering` and `ultrabrain` auto-select model tier, temperature, and thinking budget.
|
|
347
80
|
|
|
348
|
-
##
|
|
81
|
+
## Skill Composition
|
|
349
82
|
|
|
350
|
-
|
|
83
|
+
Skills compose in layers:
|
|
351
84
|
|
|
352
|
-
|
|
353
|
-
|
|
354
|
-
|
|
355
|
-
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
365
|
-
|
|
85
|
+
```
|
|
86
|
+
┌─────────────────────────────────────────────────────────────┐
|
|
87
|
+
│ GUARANTEE LAYER (optional) │
|
|
88
|
+
│ ralph: "Cannot stop until verified done" │
|
|
89
|
+
└─────────────────────────────────────────────────────────────┘
|
|
90
|
+
│
|
|
91
|
+
▼
|
|
92
|
+
┌─────────────────────────────────────────────────────────────┐
|
|
93
|
+
│ ENHANCEMENT LAYER (0-N skills) │
|
|
94
|
+
│ ultrawork (parallel) | git-master (commits) | frontend-ui-ux│
|
|
95
|
+
└─────────────────────────────────────────────────────────────┘
|
|
96
|
+
│
|
|
97
|
+
▼
|
|
98
|
+
┌─────────────────────────────────────────────────────────────┐
|
|
99
|
+
│ EXECUTION LAYER (primary skill) │
|
|
100
|
+
│ default (build) | orchestrate (coordinate) | planner (plan) │
|
|
101
|
+
└─────────────────────────────────────────────────────────────┘
|
|
102
|
+
```
|
|
366
103
|
|
|
367
|
-
|
|
104
|
+
**Formula:** `[Execution Skill] + [0-N Enhancements] + [Optional Guarantee]`
|
|
368
105
|
|
|
369
|
-
##
|
|
106
|
+
## State Management
|
|
370
107
|
|
|
371
|
-
|
|
108
|
+
State files follow standardized locations:
|
|
372
109
|
|
|
373
|
-
|
|
374
|
-
|
|
375
|
-
|
|
376
|
-
4. **Judgment-based** routing (Claude decides based on task)
|
|
110
|
+
**Local Project State:**
|
|
111
|
+
- `.omc/state/{name}.json` - Session state (ultrapilot, swarm, pipeline)
|
|
112
|
+
- `.omc/notepads/{plan-name}/` - Plan-scoped wisdom capture
|
|
377
113
|
|
|
378
|
-
|
|
114
|
+
**Global State:**
|
|
115
|
+
- `~/.omc/state/{name}.json` - User preferences and global config
|
|
379
116
|
|
|
380
|
-
|
|
117
|
+
Legacy locations are auto-migrated on read.
|
|
381
118
|
|
|
382
|
-
##
|
|
119
|
+
## Hooks
|
|
383
120
|
|
|
384
|
-
|
|
385
|
-
- [Claude Code Skills](https://docs.anthropic.com/claude-code/skills) - Skill documentation
|
|
386
|
-
- [Intelligent Skill Activation](../README.md#intelligent-skill-activation-beta) - Beta feature docs
|
|
121
|
+
oh-my-claudecode uses Claude Code's hooks system for lifecycle events:
|
|
387
122
|
|
|
388
|
-
|
|
123
|
+
- **conversationStart**: Initialize OMC, check for active modes
|
|
124
|
+
- **beforeRequest**: Task delegation, skill routing
|
|
125
|
+
- **afterResponse**: State updates, verification checks
|
|
389
126
|
|
|
390
|
-
|
|
127
|
+
Hooks are defined in `.claude/hooks/` and managed through the plugin system.
|
|
391
128
|
|
|
392
|
-
|
|
129
|
+
## Verification Protocol
|
|
393
130
|
|
|
394
|
-
|
|
395
|
-
Task Prompt Category Detection Model Selection
|
|
396
|
-
─────────── ────────────────── ───────────────
|
|
397
|
-
│ │ │
|
|
398
|
-
▼ ▼ ▼
|
|
399
|
-
┌─────────────┐ ┌──────────────────┐ ┌─────────────────┐
|
|
400
|
-
│ "Design a │ │ detectCategory │ │ ComplexityTier │
|
|
401
|
-
│ beautiful │──────────▶│ FromPrompt() │─────────▶│ │
|
|
402
|
-
│ dashboard" │ │ │ │ HIGH → opus │
|
|
403
|
-
└─────────────┘ │ Keywords: │ │ MEDIUM → sonnet │
|
|
404
|
-
│ - design ✓ │ │ LOW → haiku │
|
|
405
|
-
│ - dashboard ✓ │ └─────────────────┘
|
|
406
|
-
│ │ │
|
|
407
|
-
│ Category: │ ▼
|
|
408
|
-
│ visual-engineering│ ┌─────────────────┐
|
|
409
|
-
└──────────────────┘ │ Config Applied │
|
|
410
|
-
│ tier: HIGH │
|
|
411
|
-
│ temp: 0.7 │
|
|
412
|
-
│ thinking: high │
|
|
413
|
-
└─────────────────┘
|
|
414
|
-
```
|
|
131
|
+
The verification module ensures work completion with evidence:
|
|
415
132
|
|
|
416
|
-
|
|
133
|
+
**Standard Checks:**
|
|
134
|
+
- BUILD: Compilation passes
|
|
135
|
+
- TEST: All tests pass
|
|
136
|
+
- LINT: No linting errors
|
|
137
|
+
- FUNCTIONALITY: Feature works as expected
|
|
138
|
+
- ARCHITECT: Opus-tier review approval
|
|
139
|
+
- TODO: All tasks completed
|
|
140
|
+
- ERROR_FREE: No unresolved errors
|
|
417
141
|
|
|
418
|
-
|
|
419
|
-
.omc/
|
|
420
|
-
└── notepads/
|
|
421
|
-
└── {plan-name}/
|
|
422
|
-
├── learnings.md # Technical discoveries
|
|
423
|
-
├── decisions.md # Architectural choices
|
|
424
|
-
├── issues.md # Known issues + workarounds
|
|
425
|
-
└── problems.md # Blockers requiring resolution
|
|
426
|
-
|
|
427
|
-
Entry Format:
|
|
428
|
-
┌─────────────────────────────────────────┐
|
|
429
|
-
│ ## 2024-01-15 14:30:00 │
|
|
430
|
-
│ │
|
|
431
|
-
│ Content of the wisdom entry... │
|
|
432
|
-
└─────────────────────────────────────────┘
|
|
433
|
-
```
|
|
142
|
+
Evidence must be fresh (within 5 minutes) and include actual command output.
|
|
434
143
|
|
|
435
|
-
|
|
144
|
+
## For More Details
|
|
436
145
|
|
|
437
|
-
|
|
438
|
-
|
|
439
|
-
|
|
440
|
-
│ Diagnostics() │
|
|
441
|
-
└────────┬─────────┘
|
|
442
|
-
│
|
|
443
|
-
┌──────────────┴──────────────┐
|
|
444
|
-
│ strategy = ? │
|
|
445
|
-
└──────────────┬──────────────┘
|
|
446
|
-
│
|
|
447
|
-
┌───────────────────┼───────────────────┐
|
|
448
|
-
│ │ │
|
|
449
|
-
strategy='tsc' strategy='auto' strategy='lsp'
|
|
450
|
-
│ │ │
|
|
451
|
-
▼ ▼ ▼
|
|
452
|
-
┌───────────┐ ┌───────────┐ ┌───────────┐
|
|
453
|
-
│ tsc │ │ tsconfig │ │ LSP │
|
|
454
|
-
│ --noEmit │ │ exists? │ │ Iteration │
|
|
455
|
-
│ (fast) │ │ │ │ (fallback)│
|
|
456
|
-
└───────────┘ └─────┬─────┘ └───────────┘
|
|
457
|
-
│
|
|
458
|
-
┌───────┴───────┐
|
|
459
|
-
│ YES NO │
|
|
460
|
-
└───────┬───────┘
|
|
461
|
-
│
|
|
462
|
-
┌─────────┴─────────┐
|
|
463
|
-
▼ ▼
|
|
464
|
-
Use tsc Use LSP
|
|
465
|
-
```
|
|
146
|
+
- **API Reference**: See [FEATURES.md](./FEATURES.md)
|
|
147
|
+
- **User Guide**: See [README.md](../README.md)
|
|
148
|
+
- **Skills Reference**: See CLAUDE.md in your project
|