oh-my-customcode 0.16.2 → 0.16.4
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 +3 -3
- package/dist/cli/index.js +23 -2
- package/package.json +6 -2
- package/templates/.claude/ontology/graphs/full-graph.json +1 -1
- package/templates/.claude/ontology/rules.yaml +11 -11
- package/templates/.claude/rules/MUST-agent-teams.md +167 -0
- package/templates/.claude/rules/MUST-orchestrator-coordination.md +25 -2
- package/templates/.claude/rules/index.yaml +4 -4
- package/templates/CLAUDE.md.en +4 -6
- package/templates/CLAUDE.md.ko +4 -6
- package/templates/.claude/rules/SHOULD-agent-teams.md +0 -107
package/README.md
CHANGED
|
@@ -21,7 +21,7 @@ Like oh-my-zsh transformed shell customization, oh-my-customcode makes personali
|
|
|
21
21
|
|
|
22
22
|
| Feature | Description |
|
|
23
23
|
|---------|-------------|
|
|
24
|
-
| **Batteries Included** | 42 agents, 55 skills, 22 guides, 18 rules,
|
|
24
|
+
| **Batteries Included** | 42 agents, 55 skills, 22 guides, 18 rules, 2 hooks, 4 contexts, ontology graph - ready to use out of the box |
|
|
25
25
|
| **Sub-Agent Model** | Supports hierarchical agent orchestration with specialized roles |
|
|
26
26
|
| **Dead Simple Customization** | Create a folder + markdown file = new agent or skill |
|
|
27
27
|
| **Mix and Match** | Use built-in components, create your own, or combine both |
|
|
@@ -161,7 +161,7 @@ Comprehensive reference documentation covering:
|
|
|
161
161
|
| **SHOULD** | 5 | Interactions, error handling (recommended) |
|
|
162
162
|
| **MAY** | 1 | Optimization guidelines (optional) |
|
|
163
163
|
|
|
164
|
-
### Hooks (
|
|
164
|
+
### Hooks (2)
|
|
165
165
|
|
|
166
166
|
Event-driven automation for agent lifecycle events (PreToolUse, PostToolUse, etc.).
|
|
167
167
|
|
|
@@ -219,7 +219,7 @@ your-project/
|
|
|
219
219
|
├── CLAUDE.md # Entry point for Claude
|
|
220
220
|
└── .claude/
|
|
221
221
|
├── rules/ # Behavior rules (18 total)
|
|
222
|
-
├── hooks/ # Event hooks (
|
|
222
|
+
├── hooks/ # Event hooks (2 total)
|
|
223
223
|
├── contexts/ # Context files (4 total)
|
|
224
224
|
├── agents/ # Agent definitions (42 flat .md files)
|
|
225
225
|
│ ├── lang-golang-expert.md
|
package/dist/cli/index.js
CHANGED
|
@@ -5,15 +5,29 @@ var __getProtoOf = Object.getPrototypeOf;
|
|
|
5
5
|
var __defProp = Object.defineProperty;
|
|
6
6
|
var __getOwnPropNames = Object.getOwnPropertyNames;
|
|
7
7
|
var __hasOwnProp = Object.prototype.hasOwnProperty;
|
|
8
|
+
function __accessProp(key) {
|
|
9
|
+
return this[key];
|
|
10
|
+
}
|
|
11
|
+
var __toESMCache_node;
|
|
12
|
+
var __toESMCache_esm;
|
|
8
13
|
var __toESM = (mod, isNodeMode, target) => {
|
|
14
|
+
var canCache = mod != null && typeof mod === "object";
|
|
15
|
+
if (canCache) {
|
|
16
|
+
var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
|
|
17
|
+
var cached = cache.get(mod);
|
|
18
|
+
if (cached)
|
|
19
|
+
return cached;
|
|
20
|
+
}
|
|
9
21
|
target = mod != null ? __create(__getProtoOf(mod)) : {};
|
|
10
22
|
const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
|
|
11
23
|
for (let key of __getOwnPropNames(mod))
|
|
12
24
|
if (!__hasOwnProp.call(to, key))
|
|
13
25
|
__defProp(to, key, {
|
|
14
|
-
get: (
|
|
26
|
+
get: __accessProp.bind(mod, key),
|
|
15
27
|
enumerable: true
|
|
16
28
|
});
|
|
29
|
+
if (canCache)
|
|
30
|
+
cache.set(mod, to);
|
|
17
31
|
return to;
|
|
18
32
|
};
|
|
19
33
|
var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
|
|
@@ -14174,7 +14188,14 @@ async function checkExistingInstallation(targetDir) {
|
|
|
14174
14188
|
const rootDir = join6(targetDir, layout.rootDir);
|
|
14175
14189
|
return fileExists(rootDir);
|
|
14176
14190
|
}
|
|
14177
|
-
var PROVIDER_SUBDIR_COMPONENTS = new Set([
|
|
14191
|
+
var PROVIDER_SUBDIR_COMPONENTS = new Set([
|
|
14192
|
+
"rules",
|
|
14193
|
+
"hooks",
|
|
14194
|
+
"contexts",
|
|
14195
|
+
"agents",
|
|
14196
|
+
"skills",
|
|
14197
|
+
"ontology"
|
|
14198
|
+
]);
|
|
14178
14199
|
function componentToPath(targetDir, component) {
|
|
14179
14200
|
if (component === "entry-md") {
|
|
14180
14201
|
const layout = getProviderLayout();
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "oh-my-customcode",
|
|
3
|
-
"version": "0.16.
|
|
3
|
+
"version": "0.16.4",
|
|
4
4
|
"description": "Batteries-included agent harness for Claude Code",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -46,7 +46,7 @@
|
|
|
46
46
|
"yaml": "^2.8.2"
|
|
47
47
|
},
|
|
48
48
|
"devDependencies": {
|
|
49
|
-
"@anthropic-ai/sdk": "^0.
|
|
49
|
+
"@anthropic-ai/sdk": "^0.78.0",
|
|
50
50
|
"@biomejs/biome": "^2.3.12",
|
|
51
51
|
"@types/bun": "^1.3.6",
|
|
52
52
|
"@types/js-yaml": "^4.0.9",
|
|
@@ -76,5 +76,9 @@
|
|
|
76
76
|
"homepage": "https://github.com/baekenough/oh-my-customcode#readme",
|
|
77
77
|
"engines": {
|
|
78
78
|
"node": ">=18.0.0"
|
|
79
|
+
},
|
|
80
|
+
"overrides": {
|
|
81
|
+
"rollup": "^4.59.0",
|
|
82
|
+
"esbuild": "^0.25.0"
|
|
79
83
|
}
|
|
80
84
|
}
|
|
@@ -111,7 +111,7 @@
|
|
|
111
111
|
"R011": { "type": "Rule", "class": "ShouldRule" },
|
|
112
112
|
"R012": { "type": "Rule", "class": "ShouldRule" },
|
|
113
113
|
"R013": { "type": "Rule", "class": "ShouldRule" },
|
|
114
|
-
"R018": { "type": "Rule", "class": "
|
|
114
|
+
"R018": { "type": "Rule", "class": "MustRule" },
|
|
115
115
|
"R005": { "type": "Rule", "class": "MayRule" }
|
|
116
116
|
},
|
|
117
117
|
"edges": [
|
|
@@ -6,10 +6,10 @@ generated_at: "2026-02-12T00:00:00Z"
|
|
|
6
6
|
# Rule priority classes
|
|
7
7
|
classes:
|
|
8
8
|
MustRule:
|
|
9
|
-
rules: [R000, R001, R002, R006, R007, R008, R009, R010, R015, R016, R017]
|
|
9
|
+
rules: [R000, R001, R002, R006, R007, R008, R009, R010, R015, R016, R017, R018]
|
|
10
10
|
description: "Mandatory rules - violation requires immediate correction"
|
|
11
11
|
ShouldRule:
|
|
12
|
-
rules: [R003, R004, R011, R012, R013
|
|
12
|
+
rules: [R003, R004, R011, R012, R013]
|
|
13
13
|
description: "Recommended rules - strong guidance"
|
|
14
14
|
MayRule:
|
|
15
15
|
rules: [R005]
|
|
@@ -231,21 +231,21 @@ rules:
|
|
|
231
231
|
applies_to: [agent-modification, skill-modification, guide-modification, rules-modification]
|
|
232
232
|
|
|
233
233
|
R018:
|
|
234
|
-
class:
|
|
234
|
+
class: MustRule
|
|
235
235
|
categories: [teams]
|
|
236
|
-
title: "Agent Teams Rules"
|
|
237
|
-
filename: "
|
|
238
|
-
summary: "
|
|
239
|
-
keywords: [agent-teams, coordination, shared-state, task-tool, broadcast, message, cost]
|
|
240
|
-
token_estimate:
|
|
236
|
+
title: "Agent Teams Rules (Conditional)"
|
|
237
|
+
filename: "MUST-agent-teams.md"
|
|
238
|
+
summary: "When Agent Teams enabled, MANDATORY for 3+ agent coordinated tasks with shared state or review cycles. Task tool fallback when disabled."
|
|
239
|
+
keywords: [agent-teams, coordination, shared-state, task-tool, broadcast, message, cost, mandatory]
|
|
240
|
+
token_estimate: 850
|
|
241
241
|
applies_to: [multi-agent-coordination, complex-research]
|
|
242
242
|
|
|
243
243
|
# Metadata
|
|
244
244
|
metadata:
|
|
245
245
|
total_rules: 18
|
|
246
|
-
must_rules:
|
|
247
|
-
should_rules:
|
|
246
|
+
must_rules: 12
|
|
247
|
+
should_rules: 5
|
|
248
248
|
may_rules: 1
|
|
249
|
-
total_tokens_estimate:
|
|
249
|
+
total_tokens_estimate: 5901
|
|
250
250
|
source_directory: "templates/.claude/rules/"
|
|
251
251
|
generated_by: "claude (default)"
|
|
@@ -0,0 +1,167 @@
|
|
|
1
|
+
# [MUST] Agent Teams Rules (Conditional)
|
|
2
|
+
|
|
3
|
+
> **Priority**: MUST - ENFORCED | **ID**: R018
|
|
4
|
+
> **Condition**: Agent Teams enabled (`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`)
|
|
5
|
+
> **Fallback**: When disabled, R009/R010 apply
|
|
6
|
+
|
|
7
|
+
## Detection
|
|
8
|
+
|
|
9
|
+
Available when `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` or TeamCreate/SendMessage tools present.
|
|
10
|
+
|
|
11
|
+
## Decision Matrix
|
|
12
|
+
|
|
13
|
+
| Scenario | Preferred | Reason |
|
|
14
|
+
|----------|-----------|--------|
|
|
15
|
+
| Simple independent subtasks | Task Tool | Lower cost, no coordination overhead |
|
|
16
|
+
| Multi-step with shared state | **Agent Teams** | Shared task list, peer messaging |
|
|
17
|
+
| Research requiring discussion | **Agent Teams** | Iterative discovery, synthesis |
|
|
18
|
+
| Cost-sensitive batch ops | Task Tool | Minimal token overhead |
|
|
19
|
+
| Complex debugging across modules | **Agent Teams** | Cross-module state sharing |
|
|
20
|
+
| Code review + fix cycle | **Agent Teams** | Review → fix → re-review loop |
|
|
21
|
+
| Single file operations | Task Tool | Overkill for simple tasks |
|
|
22
|
+
| Dynamic agent creation + usage | **Agent Teams** | Create → test → iterate cycle |
|
|
23
|
+
|
|
24
|
+
**When Agent Teams is enabled and criteria are met, usage is MANDATORY.**
|
|
25
|
+
|
|
26
|
+
## Self-Check (MANDATORY Before Task Tool)
|
|
27
|
+
|
|
28
|
+
BEFORE using Task tool for 2+ agent tasks, this check is **ENFORCED**:
|
|
29
|
+
|
|
30
|
+
```
|
|
31
|
+
╔══════════════════════════════════════════════════════════════════╗
|
|
32
|
+
║ BEFORE USING Task TOOL FOR 2+ AGENTS: ║
|
|
33
|
+
║ ║
|
|
34
|
+
║ 1. Is Agent Teams available? ║
|
|
35
|
+
║ YES → MUST check criteria #2-#5 ║
|
|
36
|
+
║ NO → Proceed with Task tool ║
|
|
37
|
+
║ ║
|
|
38
|
+
║ 2. Do 2+ agents need to coordinate? → Agent Teams ║
|
|
39
|
+
║ 3. Is there a review/fix/iterate cycle? → Agent Teams ║
|
|
40
|
+
║ 4. Do agents need shared state? → Agent Teams ║
|
|
41
|
+
║ 5. Is research requiring synthesis? → Agent Teams ║
|
|
42
|
+
║ ║
|
|
43
|
+
║ If YES to #1 AND any of #2-#5: ║
|
|
44
|
+
║ → MUST use Agent Teams ║
|
|
45
|
+
║ → Using Task tool instead is a VIOLATION ║
|
|
46
|
+
║ ║
|
|
47
|
+
║ Exception: Cost-sensitive batch ops with no inter-agent need ║
|
|
48
|
+
╚══════════════════════════════════════════════════════════════════╝
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
## Common Violations
|
|
52
|
+
|
|
53
|
+
```
|
|
54
|
+
❌ WRONG: Agent Teams enabled, 3+ research tasks using Task tool
|
|
55
|
+
Task(Explore):haiku → Analysis 1
|
|
56
|
+
Task(Explore):haiku → Analysis 2
|
|
57
|
+
Task(Explore):haiku → Analysis 3
|
|
58
|
+
|
|
59
|
+
✓ CORRECT: TeamCreate → spawn researchers → coordinate via shared task list
|
|
60
|
+
TeamCreate("research-team")
|
|
61
|
+
Task(researcher-1) → Analysis 1 ┐
|
|
62
|
+
Task(researcher-2) → Analysis 2 ├─ Spawned as team members
|
|
63
|
+
Task(researcher-3) → Analysis 3 ┘
|
|
64
|
+
SendMessage(coordinate)
|
|
65
|
+
|
|
66
|
+
❌ WRONG: Code review + fix as independent Tasks
|
|
67
|
+
Task(reviewer) → "Review code"
|
|
68
|
+
(receive result)
|
|
69
|
+
Task(implementer) → "Fix issues"
|
|
70
|
+
(receive result)
|
|
71
|
+
Task(reviewer) → "Re-review"
|
|
72
|
+
|
|
73
|
+
✓ CORRECT: Agent Teams for review-fix cycle
|
|
74
|
+
TeamCreate("review-fix")
|
|
75
|
+
Task(reviewer) + Task(implementer) → team members
|
|
76
|
+
reviewer → SendMessage(implementer, "issues found")
|
|
77
|
+
implementer → fixes → SendMessage(reviewer, "fixed")
|
|
78
|
+
reviewer → re-reviews → done
|
|
79
|
+
|
|
80
|
+
❌ WRONG: Multi-expert task without coordination
|
|
81
|
+
Task(lang-typescript-expert) → "Implement frontend"
|
|
82
|
+
Task(be-express-expert) → "Implement API"
|
|
83
|
+
(no shared state, results manually combined)
|
|
84
|
+
|
|
85
|
+
✓ CORRECT: Agent Teams for cross-domain work
|
|
86
|
+
TeamCreate("fullstack")
|
|
87
|
+
Task(frontend-dev) + Task(backend-dev) → team members
|
|
88
|
+
Shared TaskList for interface contracts
|
|
89
|
+
SendMessage for API schema coordination
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
## Cost Guidelines
|
|
93
|
+
|
|
94
|
+
| Criteria | Task Tool | Agent Teams |
|
|
95
|
+
|----------|-----------|-------------|
|
|
96
|
+
| Agent count | 1-2 | 3+ |
|
|
97
|
+
| Inter-task dependency | None | Present |
|
|
98
|
+
| Iteration cycles | None | Present (review→fix→re-review) |
|
|
99
|
+
| Estimated duration | < 3 min | > 3 min |
|
|
100
|
+
| Shared state needed | No | Yes |
|
|
101
|
+
|
|
102
|
+
## Team Patterns
|
|
103
|
+
|
|
104
|
+
### Standard Patterns
|
|
105
|
+
|
|
106
|
+
- **Research**: researcher-1 + researcher-2 + synthesizer
|
|
107
|
+
- **Development**: implementer + reviewer + tester
|
|
108
|
+
- **Debug**: investigator-1 + investigator-2 + fixer
|
|
109
|
+
|
|
110
|
+
### Hybrid Patterns
|
|
111
|
+
|
|
112
|
+
- **Review+Fix**: reviewer + implementer (reviewer finds issues → implementer fixes → reviewer re-checks)
|
|
113
|
+
- **Create+Validate**: mgr-creator + qa-engineer (create agent → validate → iterate)
|
|
114
|
+
- **Multi-Expert**: expert-1 + expert-2 + coordinator (cross-domain tasks requiring multiple specialties)
|
|
115
|
+
|
|
116
|
+
### Dynamic Patterns
|
|
117
|
+
|
|
118
|
+
- **Dynamic Creation**: mgr-creator + domain-expert (create new agent → immediately use for pending task)
|
|
119
|
+
- **Codex Hybrid**: codex-exec-agent + claude-reviewer (Codex generates → Claude reviews/refines)
|
|
120
|
+
|
|
121
|
+
## Codex-Exec Integration
|
|
122
|
+
|
|
123
|
+
When both Agent Teams and codex-exec are available:
|
|
124
|
+
|
|
125
|
+
```
|
|
126
|
+
Hybrid Workflow:
|
|
127
|
+
1. Claude agent analyzes requirements
|
|
128
|
+
2. codex-exec generates implementation (Codex strength: code generation)
|
|
129
|
+
3. Claude agent reviews and refines (Claude strength: reasoning, quality)
|
|
130
|
+
4. Iterate via team messaging until quality meets standards
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
| Step | Agent | Model |
|
|
134
|
+
|------|-------|-------|
|
|
135
|
+
| Analysis | Claude team member | sonnet/opus |
|
|
136
|
+
| Generation | codex-exec | o3/o4-mini |
|
|
137
|
+
| Review | Claude team member | sonnet |
|
|
138
|
+
| Refinement | Appropriate expert | sonnet |
|
|
139
|
+
|
|
140
|
+
## Dynamic Agent Creation in Teams
|
|
141
|
+
|
|
142
|
+
When Agent Teams creates a new agent via mgr-creator:
|
|
143
|
+
|
|
144
|
+
1. Team lead identifies missing expertise
|
|
145
|
+
2. Spawns mgr-creator as team member
|
|
146
|
+
3. mgr-creator creates agent with auto-discovered skills
|
|
147
|
+
4. New agent joins team immediately
|
|
148
|
+
5. Team continues with expanded capabilities
|
|
149
|
+
|
|
150
|
+
## Lifecycle
|
|
151
|
+
|
|
152
|
+
```
|
|
153
|
+
TeamCreate → TaskCreate → Task(spawn members) → SendMessage(coordinate)
|
|
154
|
+
→ TaskUpdate(progress) → ... → shutdown members → TeamDelete
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
## Fallback
|
|
158
|
+
|
|
159
|
+
When Agent Teams unavailable: use Task tool with R009/R010 rules. Both approaches produce results; Agent Teams adds coordination richness.
|
|
160
|
+
|
|
161
|
+
## Cost Awareness
|
|
162
|
+
|
|
163
|
+
Agent Teams uses more tokens (full context per member + message passing). Use Task tool when:
|
|
164
|
+
- Task takes < 3 minutes
|
|
165
|
+
- No inter-agent communication needed
|
|
166
|
+
- Simple independent subtasks only
|
|
167
|
+
- Cost is the primary concern
|
|
@@ -191,9 +191,32 @@ CORRECT:
|
|
|
191
191
|
The skill's WORKFLOW is followed, but git EXECUTION is delegated to mgr-gitnerd per R010.
|
|
192
192
|
```
|
|
193
193
|
|
|
194
|
-
## Agent Teams (when enabled)
|
|
194
|
+
## Agent Teams (MUST when enabled)
|
|
195
195
|
|
|
196
|
-
When `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`:
|
|
196
|
+
When `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`: Agent Teams is **MANDATORY** for qualifying tasks per R018 (MUST-agent-teams.md).
|
|
197
|
+
|
|
198
|
+
### Architecture (Agent Teams enabled)
|
|
199
|
+
|
|
200
|
+
```
|
|
201
|
+
Main Conversation (orchestrator)
|
|
202
|
+
├─ Simple/independent tasks → Task tool (R009)
|
|
203
|
+
└─ Collaborative/iterative tasks → Agent Teams (R018)
|
|
204
|
+
├─ TeamCreate
|
|
205
|
+
├─ TaskCreate (shared tasks)
|
|
206
|
+
├─ Task(spawn members)
|
|
207
|
+
└─ SendMessage(coordinate)
|
|
208
|
+
```
|
|
209
|
+
|
|
210
|
+
### When to Use Agent Teams vs Task Tool
|
|
211
|
+
|
|
212
|
+
| Criteria | Task Tool | Agent Teams (MUST) |
|
|
213
|
+
|----------|-----------|-------------------|
|
|
214
|
+
| Agent count | 1-2 | 3+ |
|
|
215
|
+
| Coordination needed | No | Yes |
|
|
216
|
+
| Review/fix cycles | No | Yes |
|
|
217
|
+
| Shared state | No | Yes |
|
|
218
|
+
|
|
219
|
+
Using Task tool when Agent Teams criteria are met is a **VIOLATION** of R018.
|
|
197
220
|
|
|
198
221
|
## Announcement Format
|
|
199
222
|
|
|
@@ -124,12 +124,12 @@ rules:
|
|
|
124
124
|
priority: SHOULD
|
|
125
125
|
scope: all
|
|
126
126
|
|
|
127
|
-
# Agent Teams -
|
|
127
|
+
# Agent Teams - MUST (Conditional)
|
|
128
128
|
- id: R018
|
|
129
129
|
name: agent-teams
|
|
130
|
-
title: Agent Teams Rules
|
|
131
|
-
path: ./
|
|
132
|
-
priority:
|
|
130
|
+
title: Agent Teams Rules (Conditional)
|
|
131
|
+
path: ./MUST-agent-teams.md
|
|
132
|
+
priority: MUST
|
|
133
133
|
scope: orchestrator
|
|
134
134
|
|
|
135
135
|
# MAY - Optional
|
package/templates/CLAUDE.md.en
CHANGED
|
@@ -122,6 +122,7 @@ Violation = immediate correction. No exception for "small changes".
|
|
|
122
122
|
| R010 | Orchestrator Coordination | **ENFORCED** - Orchestrator coordination, session continuity, direct action prohibition |
|
|
123
123
|
| R016 | Continuous Improvement | **ENFORCED** - Update rules when violations occur |
|
|
124
124
|
| R017 | Sync Verification | **ENFORCED** - Verify sync before structural changes |
|
|
125
|
+
| R018 | Agent Teams | **ENFORCED (Conditional)** - Mandatory for qualifying tasks when Agent Teams enabled |
|
|
125
126
|
|
|
126
127
|
### SHOULD (Strongly recommended)
|
|
127
128
|
| ID | Rule | Description |
|
|
@@ -132,7 +133,6 @@ Violation = immediate correction. No exception for "small changes".
|
|
|
132
133
|
| R012 | HUD Statusline | Real-time status display |
|
|
133
134
|
| R013 | Ecomode | Token efficiency for batch ops |
|
|
134
135
|
| R015 | Intent Transparency | **MUST** - Transparent agent routing |
|
|
135
|
-
| R018 | Agent Teams | Active use of Agent Teams when enabled |
|
|
136
136
|
|
|
137
137
|
### MAY (Optional)
|
|
138
138
|
| ID | Rule | Description |
|
|
@@ -219,7 +219,7 @@ This is the core oh-my-customcode philosophy: **"No expert? CREATE one, connect
|
|
|
219
219
|
| System | 2 | sys-memory-keeper, sys-naggy |
|
|
220
220
|
| **Total** | **42** | |
|
|
221
221
|
|
|
222
|
-
## Agent Teams
|
|
222
|
+
## Agent Teams (MUST when enabled)
|
|
223
223
|
|
|
224
224
|
When Claude Code's Agent Teams feature is enabled (`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`), actively use it for qualifying tasks.
|
|
225
225
|
|
|
@@ -230,8 +230,8 @@ When Claude Code's Agent Teams feature is enabled (`CLAUDE_CODE_EXPERIMENTAL_AGE
|
|
|
230
230
|
| Best for | Focused tasks | Research, review, debugging |
|
|
231
231
|
| Token cost | Lower | Higher |
|
|
232
232
|
|
|
233
|
-
**When enabled,
|
|
234
|
-
See R018 (
|
|
233
|
+
**When enabled, Agent Teams is MANDATORY for qualifying collaborative tasks (R018 MUST).**
|
|
234
|
+
See R018 (MUST-agent-teams.md) for the decision matrix.
|
|
235
235
|
Hybrid patterns (Claude + Codex, Dynamic Creation + Teams) are supported.
|
|
236
236
|
Task tool + routing skills remain the fallback for simple/cost-sensitive tasks.
|
|
237
237
|
|
|
@@ -268,7 +268,6 @@ Install via `/plugin install <name>`:
|
|
|
268
268
|
| superpowers | claude-plugins-official | TDD, debugging, collaboration patterns |
|
|
269
269
|
| superpowers-developing-for-claude-code | superpowers-marketplace | Claude Code development documentation |
|
|
270
270
|
| elements-of-style | superpowers-marketplace | Writing clarity guidelines |
|
|
271
|
-
| double-shot-latte | superpowers-marketplace | Continuation prompt automation |
|
|
272
271
|
| obsidian-skills | - | Obsidian markdown support |
|
|
273
272
|
| context7 | claude-plugins-official | Library documentation lookup |
|
|
274
273
|
|
|
@@ -288,7 +287,6 @@ Install via `/plugin install <name>`:
|
|
|
288
287
|
/plugin install superpowers
|
|
289
288
|
/plugin install superpowers-developing-for-claude-code
|
|
290
289
|
/plugin install elements-of-style
|
|
291
|
-
/plugin install double-shot-latte
|
|
292
290
|
|
|
293
291
|
# MCP setup (claude-mem)
|
|
294
292
|
npm install -g claude-mem
|
package/templates/CLAUDE.md.ko
CHANGED
|
@@ -122,6 +122,7 @@ oh-my-customcode로 구동됩니다.
|
|
|
122
122
|
| R010 | 오케스트레이터 조율 | **강제** - 오케스트레이터 조율, 세션 연속성, 직접 실행 금지 |
|
|
123
123
|
| R016 | 지속적 개선 | **강제** - 위반 발생 시 규칙 업데이트 |
|
|
124
124
|
| R017 | 동기화 검증 | **강제** - 구조 변경 전 검증 |
|
|
125
|
+
| R018 | Agent Teams | **강제(조건부)** - Agent Teams 활성화 시 적합한 작업에 필수 사용 |
|
|
125
126
|
|
|
126
127
|
### SHOULD (강력 권장)
|
|
127
128
|
| ID | 규칙 | 설명 |
|
|
@@ -132,7 +133,6 @@ oh-my-customcode로 구동됩니다.
|
|
|
132
133
|
| R012 | HUD 상태줄 | 실시간 상태 표시 |
|
|
133
134
|
| R013 | Ecomode | 배치 작업 토큰 효율성 |
|
|
134
135
|
| R015 | 의도 투명성 | **필수** - 투명한 에이전트 라우팅 |
|
|
135
|
-
| R018 | Agent Teams | 활성화 시 Agent Teams 적극 사용 |
|
|
136
136
|
|
|
137
137
|
### MAY (선택)
|
|
138
138
|
| ID | 규칙 | 설명 |
|
|
@@ -219,7 +219,7 @@ project/
|
|
|
219
219
|
| System | 2 | sys-memory-keeper, sys-naggy |
|
|
220
220
|
| **총계** | **42** | |
|
|
221
221
|
|
|
222
|
-
## Agent Teams
|
|
222
|
+
## Agent Teams (MUST when enabled)
|
|
223
223
|
|
|
224
224
|
Claude Code의 Agent Teams 기능이 활성화되어 있으면 (`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`), 적격한 작업에 적극적으로 사용합니다.
|
|
225
225
|
|
|
@@ -230,8 +230,8 @@ Claude Code의 Agent Teams 기능이 활성화되어 있으면 (`CLAUDE_CODE_EXP
|
|
|
230
230
|
| 적합한 작업 | 집중된 작업 | 리서치, 리뷰, 디버깅 |
|
|
231
231
|
| 토큰 비용 | 낮음 | 높음 |
|
|
232
232
|
|
|
233
|
-
**활성화 시, 적격한 협업 작업에 Agent Teams를
|
|
234
|
-
결정 매트릭스는 R018 (
|
|
233
|
+
**활성화 시, 적격한 협업 작업에 Agent Teams를 반드시 사용해야 합니다 (R018 MUST).**
|
|
234
|
+
결정 매트릭스는 R018 (MUST-agent-teams.md)을 참조하세요.
|
|
235
235
|
하이브리드 패턴 (Claude + Codex, 동적 생성 + Teams)이 지원됩니다.
|
|
236
236
|
단순/비용 민감 작업에는 Task tool + 라우팅 스킬이 폴백으로 유지됩니다.
|
|
237
237
|
|
|
@@ -268,7 +268,6 @@ Claude Code의 Agent Teams 기능이 활성화되어 있으면 (`CLAUDE_CODE_EXP
|
|
|
268
268
|
| superpowers | claude-plugins-official | TDD, 디버깅, 협업 패턴 |
|
|
269
269
|
| superpowers-developing-for-claude-code | superpowers-marketplace | Claude Code 개발 문서 |
|
|
270
270
|
| elements-of-style | superpowers-marketplace | 글쓰기 명확성 가이드라인 |
|
|
271
|
-
| double-shot-latte | superpowers-marketplace | 연속 프롬프트 자동화 |
|
|
272
271
|
| obsidian-skills | - | 옵시디언 마크다운 지원 |
|
|
273
272
|
| context7 | claude-plugins-official | 라이브러리 문서 조회 |
|
|
274
273
|
|
|
@@ -288,7 +287,6 @@ Claude Code의 Agent Teams 기능이 활성화되어 있으면 (`CLAUDE_CODE_EXP
|
|
|
288
287
|
/plugin install superpowers
|
|
289
288
|
/plugin install superpowers-developing-for-claude-code
|
|
290
289
|
/plugin install elements-of-style
|
|
291
|
-
/plugin install double-shot-latte
|
|
292
290
|
|
|
293
291
|
# MCP 설정 (claude-mem)
|
|
294
292
|
npm install -g claude-mem
|
|
@@ -1,107 +0,0 @@
|
|
|
1
|
-
# [SHOULD] Agent Teams Rules
|
|
2
|
-
|
|
3
|
-
> **Priority**: SHOULD | **ID**: R018 | **Condition**: Agent Teams enabled locally
|
|
4
|
-
|
|
5
|
-
## Detection
|
|
6
|
-
|
|
7
|
-
Available when `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` or TeamCreate/SendMessage tools present.
|
|
8
|
-
|
|
9
|
-
## Decision Matrix
|
|
10
|
-
|
|
11
|
-
| Scenario | Preferred | Reason |
|
|
12
|
-
|----------|-----------|--------|
|
|
13
|
-
| Simple independent subtasks | Task Tool | Lower cost, no coordination overhead |
|
|
14
|
-
| Multi-step with shared state | **Agent Teams** | Shared task list, peer messaging |
|
|
15
|
-
| Research requiring discussion | **Agent Teams** | Iterative discovery, synthesis |
|
|
16
|
-
| Cost-sensitive batch ops | Task Tool | Minimal token overhead |
|
|
17
|
-
| Complex debugging across modules | **Agent Teams** | Cross-module state sharing |
|
|
18
|
-
| Code review + fix cycle | **Agent Teams** | Review → fix → re-review loop |
|
|
19
|
-
| Single file operations | Task Tool | Overkill for simple tasks |
|
|
20
|
-
| Dynamic agent creation + usage | **Agent Teams** | Create → test → iterate cycle |
|
|
21
|
-
|
|
22
|
-
**ACTIVELY prefer Agent Teams for qualifying tasks.** The coordination richness justifies the token cost for complex work.
|
|
23
|
-
|
|
24
|
-
## Self-Check (Mandatory Before Task Tool)
|
|
25
|
-
|
|
26
|
-
BEFORE using Task tool for 2+ agent tasks, CHECK:
|
|
27
|
-
|
|
28
|
-
```
|
|
29
|
-
╔════════════════════════════════════════════════════════╗
|
|
30
|
-
║ AGENT TEAMS CHECK: ║
|
|
31
|
-
║ ║
|
|
32
|
-
║ 1. Is Agent Teams available? ║
|
|
33
|
-
║ 2. Does task need 3+ agents? ║
|
|
34
|
-
║ 3. Do agents need shared state? ║
|
|
35
|
-
║ 4. Is inter-agent communication needed? ║
|
|
36
|
-
║ 5. Is there a review/fix/iterate cycle? ║
|
|
37
|
-
║ ║
|
|
38
|
-
║ If YES to #1 AND any of #2-#5 → USE Agent Teams ║
|
|
39
|
-
╚════════════════════════════════════════════════════════╝
|
|
40
|
-
```
|
|
41
|
-
|
|
42
|
-
## Team Patterns
|
|
43
|
-
|
|
44
|
-
### Standard Patterns
|
|
45
|
-
|
|
46
|
-
- **Research**: researcher-1 + researcher-2 + synthesizer
|
|
47
|
-
- **Development**: implementer + reviewer + tester
|
|
48
|
-
- **Debug**: investigator-1 + investigator-2 + fixer
|
|
49
|
-
|
|
50
|
-
### Hybrid Patterns
|
|
51
|
-
|
|
52
|
-
- **Review+Fix**: reviewer + implementer (reviewer finds issues → implementer fixes → reviewer re-checks)
|
|
53
|
-
- **Create+Validate**: mgr-creator + qa-engineer (create agent → validate → iterate)
|
|
54
|
-
- **Multi-Expert**: expert-1 + expert-2 + coordinator (cross-domain tasks requiring multiple specialties)
|
|
55
|
-
|
|
56
|
-
### Dynamic Patterns
|
|
57
|
-
|
|
58
|
-
- **Dynamic Creation**: mgr-creator + domain-expert (create new agent → immediately use for pending task)
|
|
59
|
-
- **Codex Hybrid**: codex-exec-agent + claude-reviewer (Codex generates → Claude reviews/refines)
|
|
60
|
-
|
|
61
|
-
## Codex-Exec Integration
|
|
62
|
-
|
|
63
|
-
When both Agent Teams and codex-exec are available:
|
|
64
|
-
|
|
65
|
-
```
|
|
66
|
-
Hybrid Workflow:
|
|
67
|
-
1. Claude agent analyzes requirements
|
|
68
|
-
2. codex-exec generates implementation (Codex strength: code generation)
|
|
69
|
-
3. Claude agent reviews and refines (Claude strength: reasoning, quality)
|
|
70
|
-
4. Iterate via team messaging until quality meets standards
|
|
71
|
-
```
|
|
72
|
-
|
|
73
|
-
| Step | Agent | Model |
|
|
74
|
-
|------|-------|-------|
|
|
75
|
-
| Analysis | Claude team member | sonnet/opus |
|
|
76
|
-
| Generation | codex-exec | o3/o4-mini |
|
|
77
|
-
| Review | Claude team member | sonnet |
|
|
78
|
-
| Refinement | Appropriate expert | sonnet |
|
|
79
|
-
|
|
80
|
-
## Dynamic Agent Creation in Teams
|
|
81
|
-
|
|
82
|
-
When Agent Teams creates a new agent via mgr-creator:
|
|
83
|
-
|
|
84
|
-
1. Team lead identifies missing expertise
|
|
85
|
-
2. Spawns mgr-creator as team member
|
|
86
|
-
3. mgr-creator creates agent with auto-discovered skills
|
|
87
|
-
4. New agent joins team immediately
|
|
88
|
-
5. Team continues with expanded capabilities
|
|
89
|
-
|
|
90
|
-
## Lifecycle
|
|
91
|
-
|
|
92
|
-
```
|
|
93
|
-
TeamCreate → TaskCreate → Task(spawn members) → SendMessage(coordinate)
|
|
94
|
-
→ TaskUpdate(progress) → ... → shutdown members → TeamDelete
|
|
95
|
-
```
|
|
96
|
-
|
|
97
|
-
## Fallback
|
|
98
|
-
|
|
99
|
-
When Agent Teams unavailable: use Task tool with R009/R010 rules. Both approaches produce results; Agent Teams adds coordination richness.
|
|
100
|
-
|
|
101
|
-
## Cost Awareness
|
|
102
|
-
|
|
103
|
-
Agent Teams uses more tokens (full context per member + message passing). Use Task tool when:
|
|
104
|
-
- Task takes < 3 minutes
|
|
105
|
-
- No inter-agent communication needed
|
|
106
|
-
- Simple independent subtasks only
|
|
107
|
-
- Cost is the primary concern
|