oh-my-customcode 0.158.0 → 0.160.0
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 +4 -4
- package/dist/cli/index.js +1 -1
- package/dist/index.js +1 -1
- package/package.json +1 -1
- package/templates/.claude/rules/MUST-agent-design.md +1 -1
- package/templates/.claude/rules/MUST-agent-teams.md +26 -16
- package/templates/.claude/skills/de-lead-routing/SKILL.md +1 -21
- package/templates/.claude/skills/dev-lead-routing/SKILL.md +1 -21
- package/templates/.claude/skills/intent-detection/SKILL.md +3 -9
- package/templates/.claude/skills/intent-detection/patterns/agent-triggers.yaml +3 -12
- package/templates/.claude/skills/research/SKILL.md +8 -35
- package/templates/.claude/skills/roundtable-debate/SKILL.md +6 -7
- package/templates/.claude/skills/structured-dev-cycle/SKILL.md +1 -12
- package/templates/CLAUDE.md +3 -2
- package/templates/guides/agent-design/google-agents-cli-patterns.md +1 -2
- package/templates/guides/multi-agent-debate-patterns/README.md +1 -10
- package/templates/guides/multi-provider-exec/README.md +2 -15
- package/templates/manifest.json +2 -2
- package/templates/.claude/skills/agora/SKILL.md +0 -288
- package/templates/.claude/skills/codex-exec/SKILL.md +0 -259
- package/templates/.claude/skills/codex-exec/scripts/codex-wrapper.cjs +0 -430
- package/templates/.claude/skills/gemini-exec/SKILL.md +0 -215
- package/templates/.claude/skills/gemini-exec/scripts/gemini-wrapper.cjs +0 -485
package/README.md
CHANGED
|
@@ -13,7 +13,7 @@
|
|
|
13
13
|
|
|
14
14
|
**[한국어 문서 (Korean)](./README_ko.md)**
|
|
15
15
|
|
|
16
|
-
49 agents.
|
|
16
|
+
49 agents. 115 skills. 23 rules. One command.
|
|
17
17
|
|
|
18
18
|
```bash
|
|
19
19
|
npm install -g oh-my-customcode && cd your-project && omcustom init
|
|
@@ -132,7 +132,7 @@ Each agent declares its tools, model, memory scope, and limitations in YAML fron
|
|
|
132
132
|
|
|
133
133
|
---
|
|
134
134
|
|
|
135
|
-
### Skills (
|
|
135
|
+
### Skills (115)
|
|
136
136
|
|
|
137
137
|
| Category | Count | Includes |
|
|
138
138
|
|----------|-------|----------|
|
|
@@ -145,7 +145,7 @@ Each agent declares its tools, model, memory scope, and limitations in YAML fron
|
|
|
145
145
|
| Package | 3 | npm-publish, npm-version, npm-audit |
|
|
146
146
|
| Optimization | 3 | optimize-analyze, optimize-bundle, optimize-report |
|
|
147
147
|
| Security | 3 | adversarial-review, cve-triage, jinja2-prompts |
|
|
148
|
-
| Other |
|
|
148
|
+
| Other | 7 | claude-native, vercel-deploy, skills-sh-search, result-aggregation, writing-clearly-and-concisely, and more |
|
|
149
149
|
|
|
150
150
|
Skills use a 3-tier scope system: `core` (universal), `harness` (agent/skill maintenance), `package` (project-specific).
|
|
151
151
|
|
|
@@ -270,7 +270,7 @@ your-project/
|
|
|
270
270
|
├── CLAUDE.md # Entry point
|
|
271
271
|
├── .claude/
|
|
272
272
|
│ ├── agents/ # 49 agent definitions
|
|
273
|
-
│ ├── skills/ #
|
|
273
|
+
│ ├── skills/ # 115 skill modules
|
|
274
274
|
│ ├── rules/ # 22 governance rules (R000-R021)
|
|
275
275
|
│ ├── hooks/ # 15 lifecycle hook scripts
|
|
276
276
|
│ ├── schemas/ # Tool input validation schemas
|
package/dist/cli/index.js
CHANGED
package/dist/index.js
CHANGED
package/package.json
CHANGED
|
@@ -72,7 +72,7 @@ domain: backend # backend | frontend | data-engineering | devops |
|
|
|
72
72
|
disableSkillShellExecution: true # Disable inline shell execution in skills (v2.1.91+)
|
|
73
73
|
```
|
|
74
74
|
|
|
75
|
-
> **Note**: When `disableSkillShellExecution` is enabled (v2.1.91+), skills that rely on inline shell execution (e.g., `
|
|
75
|
+
> **Note**: When `disableSkillShellExecution` is enabled (v2.1.91+), skills that rely on inline shell execution (e.g., `rtk-exec`) will have their shell blocks disabled. This is a security hardening option.
|
|
76
76
|
-->
|
|
77
77
|
|
|
78
78
|
<!-- DETAIL: CC Version Compatibility History
|
|
@@ -23,6 +23,7 @@ Available when `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` or TeamCreate/SendMessag
|
|
|
23
23
|
| Dynamic agent creation + usage | **Agent Teams** | Create → test → iterate cycle |
|
|
24
24
|
| Multi-issue release batch | **Agent Teams** | Shared task tracking, coordinated release |
|
|
25
25
|
| Large plan / multi-domain prompt (>5000 tokens, 3+ areas) | **Agent Teams** | Domain-split parallel writing + review loop avoids single-agent timeout |
|
|
26
|
+
| Mechanical disjoint-file refactoring (bulk delete + reference cleanup) | Agent Tool | Pure parallel edits with no peer coordination or review loop; Teams member-stall risk outweighs benefit — use standalone parallel Agents (R009) |
|
|
26
27
|
|
|
27
28
|
**When Agent Teams is enabled and criteria are met, usage is required.**
|
|
28
29
|
|
|
@@ -188,7 +189,7 @@ The skill's steps are followed, but agent spawning uses Teams when criteria are
|
|
|
188
189
|
## Team Patterns
|
|
189
190
|
|
|
190
191
|
Standard: Research (researcher-1 + researcher-2 + synthesizer), Development (implementer + reviewer + tester), Debug (investigator-1 + investigator-2 + fixer).
|
|
191
|
-
Hybrid: Review+Fix, Create+Validate, Multi-Expert, Dynamic Creation
|
|
192
|
+
Hybrid: Review+Fix, Create+Validate, Multi-Expert, Dynamic Creation.
|
|
192
193
|
|
|
193
194
|
<!-- DETAIL: Team Patterns
|
|
194
195
|
### Standard Patterns
|
|
@@ -203,21 +204,6 @@ Hybrid: Review+Fix, Create+Validate, Multi-Expert, Dynamic Creation, Codex Hybri
|
|
|
203
204
|
|
|
204
205
|
### Dynamic Patterns
|
|
205
206
|
- Dynamic Creation: mgr-creator + domain-expert (create new agent → immediately use for pending task)
|
|
206
|
-
- Codex Hybrid: codex-exec-agent + claude-reviewer (Codex generates → Claude reviews/refines)
|
|
207
|
-
|
|
208
|
-
### Codex-Exec Integration
|
|
209
|
-
When both Agent Teams and codex-exec are available:
|
|
210
|
-
1. Claude agent analyzes requirements
|
|
211
|
-
2. codex-exec generates implementation (Codex strength: code generation)
|
|
212
|
-
3. Claude agent reviews and refines (Claude strength: reasoning, quality)
|
|
213
|
-
4. Iterate via team messaging until quality meets standards
|
|
214
|
-
|
|
215
|
-
| Step | Agent | Model |
|
|
216
|
-
|------|-------|-------|
|
|
217
|
-
| Analysis | Claude team member | sonnet/opus |
|
|
218
|
-
| Generation | codex-exec | (Codex default) |
|
|
219
|
-
| Review | Claude team member | sonnet |
|
|
220
|
-
| Refinement | Appropriate expert | sonnet |
|
|
221
207
|
|
|
222
208
|
### Dynamic Agent Creation in Teams
|
|
223
209
|
When Agent Teams creates a new agent via mgr-creator:
|
|
@@ -328,3 +314,27 @@ Agent Teams 멤버는 long-running 작업 중 진행 상태를 TaskUpdate 로
|
|
|
328
314
|
- 차단 사유를 SendMessage 로만 보내고 task description 업데이트 누락 → TaskList 만 보는 멤버는 사유를 모름
|
|
329
315
|
|
|
330
316
|
Reference issue: #1087.
|
|
317
|
+
|
|
318
|
+
## Member Completion Verification (deterministic ground-truth)
|
|
319
|
+
|
|
320
|
+
Agent Teams member completion MUST be verified by deterministic ground-truth — NOT by SendMessage reports or TaskList status alone. Members may edit files without updating task status (task stays `pending`) or go idle without executing at all.
|
|
321
|
+
|
|
322
|
+
**Verification sources (in order of reliability):**
|
|
323
|
+
|
|
324
|
+
| Source | Reliability | Examples |
|
|
325
|
+
|--------|-------------|---------|
|
|
326
|
+
| `git status` / `git diff` | High — ground truth | Check that expected files changed |
|
|
327
|
+
| `grep` / file existence | High — deterministic | Verify expected content written |
|
|
328
|
+
| Validation scripts | High — deterministic | `validate-docs`, linters, test runs |
|
|
329
|
+
| TaskList status | Low — member may not update | Use as a signal only |
|
|
330
|
+
| SendMessage report | Low — member may stall before sending | Use as a signal only |
|
|
331
|
+
|
|
332
|
+
Cross-reference: R020 ("actual outcome ≠ attempt" — verifying that a command ran is not the same as verifying it succeeded).
|
|
333
|
+
|
|
334
|
+
**Stall handling**: When a member shows no task progress within ~2 minutes despite spawn + owner assignment + SendMessage coordination, reassign the work to a standalone Agent (R009) rather than continuing to nudge the stalled member. Stalled Teams members waste tokens on idle polling and delay the overall workflow.
|
|
335
|
+
|
|
336
|
+
Observed instance: v0.159.0 release (session 105) — members assigned to disjoint-file cleanup tasks went idle without executing; deterministic git-diff check exposed the gap; work was reassigned to standalone parallel Agents. References: #1261, #1262.
|
|
337
|
+
|
|
338
|
+
## Member Prompt Size Cap
|
|
339
|
+
|
|
340
|
+
Keep per-member delegation prompts under ~5000 tokens and within a single domain. Oversized or multi-domain prompts risk malformed-parsing truncation in the CC platform (see R009 giant-prompt heuristic and `feedback_agent_malformed_parsing.md`). Large multi-file delegations should be decomposed and split across multiple members or standalone Agents.
|
|
@@ -70,27 +70,7 @@ Check if Agent Teams is available (`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` or T
|
|
|
70
70
|
| Cross-tool data quality analysis | Agent Teams |
|
|
71
71
|
| Quick DAG/model validation | Agent Tool |
|
|
72
72
|
|
|
73
|
-
### Step 2:
|
|
74
|
-
For **new pipeline code**, **DAG scaffolding**, or **SQL model generation**:
|
|
75
|
-
|
|
76
|
-
1. Check `/tmp/.claude-env-status-*` for codex, gemini, and rtk availability
|
|
77
|
-
2. If codex available AND task involves new file creation → automatically delegate to `/codex-exec` for scaffolding:
|
|
78
|
-
- Display: `[Codex Hybrid] Delegating to codex-exec...`
|
|
79
|
-
- codex-exec generates initial code (strength: fast generation)
|
|
80
|
-
- Selected DE expert reviews and refines codex output (strength: reasoning, quality)
|
|
81
|
-
3. If codex unavailable but gemini available → delegate to `/gemini-exec` for scaffolding:
|
|
82
|
-
- Display: `[Gemini Hybrid] Delegating to gemini-exec...`
|
|
83
|
-
- gemini-exec generates initial code
|
|
84
|
-
- Selected DE expert reviews and refines output
|
|
85
|
-
4. If RTK available (`RTK=available` in env status) → optionally wrap DE expert output through RTK to reduce token consumption by 60-90%:
|
|
86
|
-
- Display: `[RTK Proxy] Token optimization active via rtk-exec`
|
|
87
|
-
- RTK acts as a transparent proxy — no change to expert selection
|
|
88
|
-
5. If none available → display `[External CLI] Unavailable — proceeding with {expert} directly` and use DE expert directly
|
|
89
|
-
|
|
90
|
-
**Suitable**: New DAG files, dbt model scaffolding, SQL template generation
|
|
91
|
-
**Unsuitable**: Existing pipeline modification, architecture decisions, data quality analysis
|
|
92
|
-
|
|
93
|
-
### Step 3: Expert Selection
|
|
73
|
+
### Step 2: Expert Selection
|
|
94
74
|
Route to appropriate DE expert based on tool/framework detection.
|
|
95
75
|
|
|
96
76
|
> **Permission Mode**: When spawning agents via Agent tool, always pass `mode: "bypassPermissions"`. The Agent tool default (`acceptEdits`) overrides agent frontmatter `permissionMode`, causing permission prompts during unattended execution.
|
|
@@ -109,27 +109,7 @@ Check if Agent Teams is available (`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` or T
|
|
|
109
109
|
| Cross-layer debugging (FE + BE + DB) | Agent Teams |
|
|
110
110
|
| Simple file search/validation | Task Tool |
|
|
111
111
|
|
|
112
|
-
### Step 2:
|
|
113
|
-
For **new file creation**, **boilerplate**, or **test code generation**:
|
|
114
|
-
|
|
115
|
-
1. Check `/tmp/.claude-env-status-*` for codex, gemini, and rtk availability
|
|
116
|
-
2. If codex available AND task involves new file creation → automatically delegate to `/codex-exec` for scaffolding:
|
|
117
|
-
- Display: `[Codex Hybrid] Delegating to codex-exec...`
|
|
118
|
-
- codex-exec generates initial code (strength: fast generation)
|
|
119
|
-
- Selected Claude expert reviews and refines codex output (strength: reasoning, quality)
|
|
120
|
-
3. If codex unavailable but gemini available → delegate to `/gemini-exec` for scaffolding:
|
|
121
|
-
- Display: `[Gemini Hybrid] Delegating to gemini-exec...`
|
|
122
|
-
- gemini-exec generates initial code
|
|
123
|
-
- Selected Claude expert reviews and refines output
|
|
124
|
-
4. If RTK available (`RTK=available` in env status) → optionally wrap Claude expert output through RTK to reduce token consumption by 60-90%:
|
|
125
|
-
- Display: `[RTK Proxy] Token optimization active via rtk-exec`
|
|
126
|
-
- RTK acts as a transparent proxy — no change to expert selection
|
|
127
|
-
5. If none available → display `[External CLI] Unavailable — proceeding with {expert} directly` and use Claude expert directly
|
|
128
|
-
|
|
129
|
-
**Suitable**: New file creation, boilerplate, scaffolding, test code
|
|
130
|
-
**Unsuitable**: Existing code modification, architecture decisions, bug fixes
|
|
131
|
-
|
|
132
|
-
### Step 3: Expert Agent Selection
|
|
112
|
+
### Step 2: Expert Agent Selection
|
|
133
113
|
Route to appropriate language/framework expert based on file extension and keyword mapping.
|
|
134
114
|
|
|
135
115
|
> **Permission Mode**: When spawning agents via Agent tool, always pass `mode: "bypassPermissions"`. The Agent tool default (`acceptEdits`) overrides agent frontmatter `permissionMode`, causing permission prompts during unattended execution.
|
|
@@ -277,14 +277,8 @@ english:
|
|
|
277
277
|
```
|
|
278
278
|
Research intent detected (confidence >= 70%)
|
|
279
279
|
↓
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
│ → Use codex-exec skill with --effort xhigh
|
|
283
|
-
│ → Prompt: "Research and analyze: {user_request}"
|
|
284
|
-
│ → Returns: structured findings for orchestrator
|
|
285
|
-
└─ Unavailable
|
|
286
|
-
→ Fall back to Claude's WebFetch/WebSearch
|
|
287
|
-
→ Orchestrator handles directly or via general-purpose agent
|
|
280
|
+
Use Claude's WebFetch/WebSearch
|
|
281
|
+
→ Orchestrator handles directly or via general-purpose agent
|
|
288
282
|
```
|
|
289
283
|
|
|
290
284
|
### Confidence Scoring
|
|
@@ -303,7 +297,7 @@ Check Codex CLI availability
|
|
|
303
297
|
├── Input: "{user input}"
|
|
304
298
|
├── Workflow: research-workflow
|
|
305
299
|
├── Confidence: {percentage}%
|
|
306
|
-
├── Method:
|
|
300
|
+
├── Method: WebFetch/WebSearch
|
|
307
301
|
└── Reason: {explanation}
|
|
308
302
|
```
|
|
309
303
|
|
|
@@ -338,10 +338,10 @@ agents:
|
|
|
338
338
|
- gather
|
|
339
339
|
base_confidence: 50
|
|
340
340
|
action_weight: 30
|
|
341
|
-
routing_rule: "
|
|
341
|
+
routing_rule: "Use WebFetch/WebSearch for research; orchestrator handles directly or via general-purpose agent"
|
|
342
342
|
|
|
343
343
|
# ---------------------------------------------------------------------------
|
|
344
|
-
# Code Generation (
|
|
344
|
+
# Code Generation (skill-based)
|
|
345
345
|
# ---------------------------------------------------------------------------
|
|
346
346
|
code-generation-workflow:
|
|
347
347
|
keywords:
|
|
@@ -367,7 +367,7 @@ agents:
|
|
|
367
367
|
- scaffold
|
|
368
368
|
base_confidence: 30
|
|
369
369
|
action_weight: 25
|
|
370
|
-
routing_rule: "
|
|
370
|
+
routing_rule: "Use Claude expert agents for new file creation tasks"
|
|
371
371
|
|
|
372
372
|
# Managers (continued)
|
|
373
373
|
mgr-gitnerd:
|
|
@@ -630,15 +630,6 @@ agents:
|
|
|
630
630
|
base_confidence: 75
|
|
631
631
|
routing_rule: "Invoke worker-reviewer-pipeline skill"
|
|
632
632
|
|
|
633
|
-
skill-agora:
|
|
634
|
-
keywords:
|
|
635
|
-
korean: [아고라, 합의, 적대적 합의, 다중 LLM]
|
|
636
|
-
english: [agora, consensus, "adversarial consensus", "multi llm"]
|
|
637
|
-
file_patterns: []
|
|
638
|
-
supported_actions: [debate, consensus, verify]
|
|
639
|
-
base_confidence: 85
|
|
640
|
-
routing_rule: "Invoke agora skill"
|
|
641
|
-
|
|
642
633
|
# Debugging skill
|
|
643
634
|
skill-debugging:
|
|
644
635
|
keywords:
|
|
@@ -163,32 +163,17 @@ Batch 3: T9, T10 (Innovation)
|
|
|
163
163
|
|
|
164
164
|
### Phase 2: Cross-Verification Loop (min 2, max 30 rounds)
|
|
165
165
|
|
|
166
|
-
#### Codex Availability Check
|
|
167
|
-
|
|
168
|
-
Before starting verification rounds, check codex availability:
|
|
169
|
-
|
|
170
|
-
```bash
|
|
171
|
-
# Run this check once before Phase 2 begins
|
|
172
|
-
which codex &>/dev/null && [ -n "$OPENAI_API_KEY" ]
|
|
173
|
-
# Exit 0 → codex available: enable dual-model verification (opus + codex)
|
|
174
|
-
# Exit 1 → codex unavailable: display notice and proceed with opus-only
|
|
175
|
-
```
|
|
176
|
-
|
|
177
|
-
If unavailable, display: `[Phase 2] Codex unavailable — opus-only verification`
|
|
178
|
-
|
|
179
166
|
```
|
|
180
|
-
Team findings ──→ opus 4.6 verification
|
|
181
|
-
│
|
|
167
|
+
Team findings ──→ opus 4.6 verification
|
|
168
|
+
│ │
|
|
182
169
|
└── Contradiction detected? ── YES ──→ Round N+1
|
|
183
170
|
NO ──→ Consensus reached → Phase 3
|
|
184
171
|
```
|
|
185
172
|
|
|
186
173
|
Each round:
|
|
187
174
|
1. **opus 4.6**: Deep reasoning verification — checks logical consistency, identifies gaps, challenges assumptions
|
|
188
|
-
2. **
|
|
189
|
-
|
|
190
|
-
3. **Contradiction resolution**: Reconcile divergent findings between teams and verifiers
|
|
191
|
-
4. **Convergence check**: All major claims verified with no outstanding contradictions → proceed
|
|
175
|
+
2. **Contradiction resolution**: Reconcile divergent findings between teams and verifiers
|
|
176
|
+
3. **Convergence check**: All major claims verified with no outstanding contradictions → proceed
|
|
192
177
|
|
|
193
178
|
Convergence expected by round 3. Hard stop at round 30.
|
|
194
179
|
|
|
@@ -273,8 +258,7 @@ Retrieval and reasoning are distinct cognitive operations that benefit from expl
|
|
|
273
258
|
| Phase | Model | Rationale |
|
|
274
259
|
|-------|-------|-----------|
|
|
275
260
|
| Phase 1 (Research teams) | sonnet | Balanced speed/quality for parallel research |
|
|
276
|
-
| Phase 2 (
|
|
277
|
-
| Phase 2 (codex verification) | codex xhigh | Code-level validation of technical claims |
|
|
261
|
+
| Phase 2 (Verification) | opus | Deep reasoning for cross-verification |
|
|
278
262
|
| Phase 3 (Synthesis) | opus | Complex multi-source reasoning and taxonomy |
|
|
279
263
|
|
|
280
264
|
## Team Prompt Templates
|
|
@@ -326,17 +310,7 @@ Round N:
|
|
|
326
310
|
- Internal consistency (breadth ↔ depth alignment)
|
|
327
311
|
- Cross-domain consistency (security ↔ architecture)
|
|
328
312
|
- Evidence quality (claims without backing)
|
|
329
|
-
Step 2:
|
|
330
|
-
a. Invoke: /codex-exec with findings from all teams
|
|
331
|
-
b. Prompt: "Validate technical claims: {findings}.
|
|
332
|
-
Check code patterns, benchmark reproducibility,
|
|
333
|
-
dependency resolution."
|
|
334
|
-
c. Effort: --effort xhigh
|
|
335
|
-
d. Parse: contradictions → merge with opus findings
|
|
336
|
-
e. On timeout/error: log "[Phase 2] Round {N}: codex-exec error — {reason},
|
|
337
|
-
continuing with opus results only"
|
|
338
|
-
If unavailable: log "[Phase 2] Round {N}: Codex unavailable, proceeding with opus verification only"
|
|
339
|
-
Step 3: Compile contradiction list
|
|
313
|
+
Step 2: Compile contradiction list
|
|
340
314
|
- 0 contradictions → CONVERGED
|
|
341
315
|
- >0 contradictions → feedback to relevant teams → Round N+1
|
|
342
316
|
```
|
|
@@ -417,7 +391,6 @@ This advisory is informational only and does not block execution.
|
|
|
417
391
|
|
|
418
392
|
| Scenario | Fallback |
|
|
419
393
|
|----------|----------|
|
|
420
|
-
| codex-exec unavailable | opus-only verification (still min 2 rounds) |
|
|
421
394
|
| Agent Teams unavailable | Standard Agent tool with R009 batching |
|
|
422
395
|
| Partial team failure | Synthesize from available results, note gaps in report |
|
|
423
396
|
| GitHub issue creation fails | Output report to conversation only |
|
|
@@ -428,11 +401,11 @@ Before execution:
|
|
|
428
401
|
```
|
|
429
402
|
[Research Plan] {topic}
|
|
430
403
|
├── Phase 1: 10 teams (3 batches × 4/4/2)
|
|
431
|
-
├── Phase 2: Cross-verification (2-5 rounds, opus
|
|
404
|
+
├── Phase 2: Cross-verification (2-5 rounds, opus)
|
|
432
405
|
├── Phase 3: Synthesis (opus)
|
|
433
406
|
└── Phase 4: Report + GitHub issue
|
|
434
407
|
|
|
435
|
-
Estimated: {time} | Teams: 10 | Models: sonnet → opus
|
|
408
|
+
Estimated: {time} | Teams: 10 | Models: sonnet → opus
|
|
436
409
|
Stopping: max 30 verification rounds, convergence at 0 contradictions
|
|
437
410
|
Cost: ~$8-15 (10 teams × sonnet + opus verification)
|
|
438
411
|
Execute? [Y/n]
|
|
@@ -8,16 +8,16 @@ version: 1.0.0
|
|
|
8
8
|
|
|
9
9
|
# roundtable-debate
|
|
10
10
|
|
|
11
|
-
발산 보존(divergence preservation)을 목표로 하는 다중 에이전트 구조화 토론 스킬.
|
|
11
|
+
발산 보존(divergence preservation)을 목표로 하는 다중 에이전트 구조화 토론 스킬.
|
|
12
12
|
|
|
13
13
|
## When to Use
|
|
14
14
|
|
|
15
|
-
| 상황 |
|
|
15
|
+
| 상황 | 적합 여부 |
|
|
16
16
|
|------|-----------|
|
|
17
|
-
|
|
|
18
|
-
|
|
|
19
|
-
| 단일 결정 + 단일 답변 |
|
|
20
|
-
|
|
|
17
|
+
| 다각적 평가 필요 (리스크 발굴) | 적합 |
|
|
18
|
+
| 의도적 발산 + 소수의견 보존 | 적합 |
|
|
19
|
+
| 단일 결정 + 단일 답변 | 부적합 (단일 에이전트 사용) |
|
|
20
|
+
| 만장일치 합의 필요 (스펙 확정) | 부적합 (adversarial-review 참고) |
|
|
21
21
|
|
|
22
22
|
## Anti-Groupthink Mechanisms
|
|
23
23
|
|
|
@@ -97,7 +97,6 @@ DO NOT use Write/Edit directly on `.claude/outputs/` — CC sensitive-path guard
|
|
|
97
97
|
|
|
98
98
|
| 스킬 | 목표 | 종료 조건 |
|
|
99
99
|
|------|------|----------|
|
|
100
|
-
| `agora` | 만장일치 수렴 | 모든 LLM 동의 |
|
|
101
100
|
| `roundtable-debate` | 발산 보존 | 2라운드 도달 |
|
|
102
101
|
| `adversarial-review` | 공격자 1인 시각 | 단일 라운드 |
|
|
103
102
|
| `evaluator-optimizer` | 평가-개선 루프 | 평가 통과 |
|
|
@@ -93,17 +93,6 @@ A PreToolUse hook in `.claude/hooks/hooks.json` checks this marker and blocks Wr
|
|
|
93
93
|
└── Output: Implementation complete
|
|
94
94
|
```
|
|
95
95
|
|
|
96
|
-
**Codex-Exec Hybrid Option**: When entering Stage 3:
|
|
97
|
-
1. Check `/tmp/.claude-env-status-*` for codex CLI availability
|
|
98
|
-
2. If available AND task involves new file creation → automatically delegate scaffolding to `/codex-exec`:
|
|
99
|
-
- Display: `[Codex Hybrid] Delegating scaffolding to codex-exec...`
|
|
100
|
-
- codex-exec generates initial code (strength: fast generation)
|
|
101
|
-
- Claude expert reviews and refines codex output (strength: reasoning, quality)
|
|
102
|
-
3. If unavailable → display `[Codex] Unavailable — proceeding with Claude experts directly` and proceed with standard implementation via Claude experts
|
|
103
|
-
|
|
104
|
-
Suitable for codex hybrid: new files, boilerplate, test stubs, scaffolding
|
|
105
|
-
Not suitable: modifying existing code, architecture-dependent changes
|
|
106
|
-
|
|
107
96
|
**Exit criteria**: All planned files created/modified, tests written.
|
|
108
97
|
|
|
109
98
|
### Stage 4: Verify Implementation
|
|
@@ -157,7 +146,7 @@ The stage marker file (`/tmp/.claude-dev-stage`) is read by a PreToolUse hook th
|
|
|
157
146
|
For complex tasks, Agent Teams is **preferred** when available (R018):
|
|
158
147
|
- Plan: architect agent
|
|
159
148
|
- Verify: reviewer agent(s) — multi-model-verification via Agent Teams
|
|
160
|
-
- Implement: domain expert agent
|
|
149
|
+
- Implement: domain expert agent
|
|
161
150
|
- Compound: QA agent
|
|
162
151
|
|
|
163
152
|
When Agent Teams is enabled AND task involves 3+ agents or review→fix cycles, using Agent Teams is MANDATORY per R018.
|
package/templates/CLAUDE.md
CHANGED
|
@@ -103,7 +103,7 @@ oh-my-customcode로 구동됩니다.
|
|
|
103
103
|
| 개발 | `/dev-review`, `/dev-refactor`, `/sdd-dev`, `/structured-dev-cycle` | 코드 리뷰, 리팩토링, SDD |
|
|
104
104
|
| 검증 | `/omcustom:sauron-watch`, `/deep-verify`, `/adversarial-review` | R017 검증, 릴리즈 품질, 보안 리뷰 |
|
|
105
105
|
| 릴리즈 | `/pipeline auto-dev`, `/omcustom-release-notes`, `/release-plan` | 자동 개발, 릴리즈 노트 |
|
|
106
|
-
| 리서치 | `/research`, `/scout`, `/deep-plan
|
|
106
|
+
| 리서치 | `/research`, `/scout`, `/deep-plan` | 병렬 분석, URL 평가, 연구 계획 |
|
|
107
107
|
| 최적화 | `/token-efficiency-audit` | 토큰 효율 감사 (5계층 방어 스택) |
|
|
108
108
|
| 시스템 | `/omcustom:lists`, `/omcustom:status`, `/omcustom:help` | 전체 목록, 상태, 도움말 |
|
|
109
109
|
|
|
@@ -116,7 +116,7 @@ project/
|
|
|
116
116
|
+-- CLAUDE.md # 진입점
|
|
117
117
|
+-- .claude/
|
|
118
118
|
| +-- agents/ # 서브에이전트 정의 (49 파일)
|
|
119
|
-
| +-- skills/ # 스킬 (
|
|
119
|
+
| +-- skills/ # 스킬 (115 디렉토리)
|
|
120
120
|
| +-- rules/ # 전역 규칙 (R000-R023)
|
|
121
121
|
| +-- hooks/ # 훅 스크립트 (보안, 검증, HUD)
|
|
122
122
|
| +-- contexts/ # 컨텍스트 파일 (ecomode)
|
|
@@ -235,6 +235,7 @@ Claude Code의 Agent Teams 기능이 활성화되어 있으면 (`CLAUDE_CODE_EXP
|
|
|
235
235
|
| cc-token-saver | ww-w-ai/cc-token-saver | 토큰/비용 최적화 (Token Guardian, /continue, /usage-view) |
|
|
236
236
|
| caveman | JuliusBrussee/caveman | 영어 출력 토큰 압축 (코드 리뷰·커밋 메시지). R013 ecomode 미적용 구간 보완. 한국어 컨텍스트(R000)에는 ecomode 우선. `lite`/`full` 권장, `ultra`/`文言文` 가독성 저하 주의 |
|
|
237
237
|
| cc-roundtable | gaebalai/cc-roundtable | Devil's Advocate + 소수의견 보호 + 2라운드 하드캡 다중 에이전트 토론. `roundtable-debate` 스킬에 패턴 내재화됨; 외부 플러그인 직접 사용 시 대안 경로 |
|
|
238
|
+
| codex-plugin-cc | openai/codex-plugin-cc | OpenAI Codex 하이브리드 실행 — codex-exec 스킬을 대체하는 네이티브 플러그인 경로 |
|
|
238
239
|
|
|
239
240
|
### 권장 MCP 서버
|
|
240
241
|
|
|
@@ -46,7 +46,7 @@ omcustom 관련성: 현재 skills는 Claude Code 전용으로 설계되어 있
|
|
|
46
46
|
|
|
47
47
|
여러 에이전트의 출력을 단일 synthesizer가 통합하는 구조.
|
|
48
48
|
|
|
49
|
-
omcustom에 이미 구현됨: `
|
|
49
|
+
omcustom에 이미 구현됨: `result-aggregation` skill. 추가 작업 불필요.
|
|
50
50
|
|
|
51
51
|
## Why Not Direct Adoption
|
|
52
52
|
|
|
@@ -72,5 +72,4 @@ omcustom은 로컬 Claude Code 중심 철학 → 종속 컴포넌트 직접 채
|
|
|
72
72
|
|
|
73
73
|
- #971 (source issue)
|
|
74
74
|
- mgr-creator 에이전트 (`.claude/agents/mgr-creator.md`)
|
|
75
|
-
- agora skill
|
|
76
75
|
- result-aggregation skill
|
|
@@ -25,22 +25,19 @@
|
|
|
25
25
|
- 1명만 주장하는 의견도 별도 트랙으로 보존
|
|
26
26
|
- 기각 시 명시적 정당화(3개 근거 이상) 필수
|
|
27
27
|
|
|
28
|
-
##
|
|
28
|
+
## 스킬 선택 매트릭스
|
|
29
29
|
|
|
30
30
|
| 상황 | 권장 | 이유 |
|
|
31
31
|
|------|------|------|
|
|
32
|
-
| 스펙 최종 확정 (단일 답변 필요) | `agora` | 만장일치 수렴 |
|
|
33
32
|
| 아키텍처 결정 (트레이드오프 평가) | `roundtable-debate` | 발산 보존 |
|
|
34
33
|
| 보안 감사 (공격자 시각) | `adversarial-review` | 공격자 1인 시각 |
|
|
35
34
|
| 코드 품질 개선 루프 | `evaluator-optimizer` | 평가-개선 |
|
|
36
35
|
| 리스크 발굴 (블라인드 스폿) | `roundtable-debate` | 다양한 페르소나 |
|
|
37
|
-
| 산출물 검증 (통과/실패) | `agora` | 단일 결정 |
|
|
38
36
|
|
|
39
37
|
## 종료 조건 비교
|
|
40
38
|
|
|
41
39
|
| 스킬 | 종료 조건 | 산출물 |
|
|
42
40
|
|------|----------|--------|
|
|
43
|
-
| `agora` | 모든 LLM 동의 | 단일 합의안 |
|
|
44
41
|
| `roundtable-debate` | 2라운드 도달 | 합의 + 소수의견 + Devil's Advocate 반대 |
|
|
45
42
|
| `adversarial-review` | 단일 라운드 완료 | 취약점 목록 |
|
|
46
43
|
| `evaluator-optimizer` | 평가 통과 | 개선된 산출물 |
|
|
@@ -55,11 +52,6 @@
|
|
|
55
52
|
|
|
56
53
|
## 구현 예시
|
|
57
54
|
|
|
58
|
-
`agora`(수렴):
|
|
59
|
-
```
|
|
60
|
-
사용자: "이 API 스펙이 안전한가?" → agora → "안전함 (3 LLM 만장일치)"
|
|
61
|
-
```
|
|
62
|
-
|
|
63
55
|
`roundtable-debate`(발산):
|
|
64
56
|
```
|
|
65
57
|
사용자: "OAuth vs JWT 어느 쪽이 적합?" → roundtable-debate →
|
|
@@ -75,5 +67,4 @@ cc-roundtable (https://github.com/gaebalai/cc-roundtable) 패턴에서 차용. R
|
|
|
75
67
|
## 관련 자료
|
|
76
68
|
|
|
77
69
|
- 스킬: `.claude/skills/roundtable-debate/SKILL.md`
|
|
78
|
-
- 스킬: `.claude/skills/agora/SKILL.md`
|
|
79
70
|
- 룰: R009 (병렬 실행), R018 (Agent Teams)
|
|
@@ -10,8 +10,6 @@ Inspired by OpenHarness's provider profile switching pattern, adapted for oh-my-
|
|
|
10
10
|
|
|
11
11
|
| Provider | Skill | CLI Dependency | Model | Strengths |
|
|
12
12
|
|----------|-------|---------------|-------|-----------|
|
|
13
|
-
| OpenAI (Codex) | `codex-exec` | `codex` CLI | GPT-5.4 | Code generation, broad knowledge |
|
|
14
|
-
| Google (Gemini) | `gemini-exec` | `gemini` CLI | Gemini 2.5 Pro | Long context, multimodal |
|
|
15
13
|
| RTK (proxy) | `rtk-exec` | `rtk` CLI | Configurable | Token-optimized output, cost reduction |
|
|
16
14
|
|
|
17
15
|
## Availability Detection
|
|
@@ -20,8 +18,6 @@ The `session-env-check.sh` hook (SessionStart) auto-detects available providers:
|
|
|
20
18
|
|
|
21
19
|
```
|
|
22
20
|
[SessionStart] Checking external CLI availability...
|
|
23
|
-
codex: ✓ available
|
|
24
|
-
gemini: ✗ not found
|
|
25
21
|
rtk: ✓ available
|
|
26
22
|
```
|
|
27
23
|
|
|
@@ -32,8 +28,6 @@ Providers are opt-in — missing CLIs are silently skipped.
|
|
|
32
28
|
### Direct Invocation
|
|
33
29
|
|
|
34
30
|
```
|
|
35
|
-
/codex-exec "Review this function for security issues"
|
|
36
|
-
/gemini-exec "Analyze this architecture diagram"
|
|
37
31
|
/rtk-exec "List files matching pattern X"
|
|
38
32
|
```
|
|
39
33
|
|
|
@@ -41,17 +35,12 @@ Providers are opt-in — missing CLIs are silently skipped.
|
|
|
41
35
|
|
|
42
36
|
| Task | Recommended Provider | Rationale |
|
|
43
37
|
|------|---------------------|-----------|
|
|
44
|
-
| Second opinion on code review | codex-exec | Independent model reduces confirmation bias |
|
|
45
|
-
| Long document analysis | gemini-exec | 1M+ context window |
|
|
46
38
|
| Token-heavy batch operations | rtk-exec | Compressed output reduces context cost |
|
|
47
|
-
| Security audit cross-check | codex-exec | Different training data catches different patterns |
|
|
48
|
-
| Multi-model verification | All three | `/multi-model-verification` skill orchestrates this |
|
|
49
39
|
|
|
50
40
|
### Integration with Existing Skills
|
|
51
41
|
|
|
52
42
|
| Skill | Uses Provider | How |
|
|
53
43
|
|-------|--------------|-----|
|
|
54
|
-
| `multi-model-verification` | codex-exec + gemini-exec | Parallel verification with severity classification |
|
|
55
44
|
| `reasoning-sandwich` | Any exec skill | Pre/post reasoning with different models |
|
|
56
45
|
| `model-escalation` | Claude models only | Internal escalation (haiku→sonnet→opus), not cross-provider |
|
|
57
46
|
|
|
@@ -60,9 +49,9 @@ Providers are opt-in — missing CLIs are silently skipped.
|
|
|
60
49
|
| Aspect | Multi-Model Routing | Multi-Provider Exec |
|
|
61
50
|
|--------|--------------------|--------------------|
|
|
62
51
|
| Scope | Claude model selection | Cross-provider execution |
|
|
63
|
-
| Models | haiku / sonnet / opus |
|
|
52
|
+
| Models | haiku / sonnet / opus | RTK proxy |
|
|
64
53
|
| Mechanism | `model` frontmatter field | Exec skill invocation |
|
|
65
|
-
| Use case | Cost/quality optimization within Claude |
|
|
54
|
+
| Use case | Cost/quality optimization within Claude | Token-optimized output via RTK proxy |
|
|
66
55
|
| Guide | `guides/multi-model-routing/` | `guides/multi-provider-exec/` |
|
|
67
56
|
|
|
68
57
|
## Configuration
|
|
@@ -71,8 +60,6 @@ No global configuration required. Each exec skill reads its own CLI configuratio
|
|
|
71
60
|
|
|
72
61
|
| Skill | Config Source |
|
|
73
62
|
|-------|-------------|
|
|
74
|
-
| codex-exec | `~/.codex/config` or CODEX_API_KEY env |
|
|
75
|
-
| gemini-exec | `~/.gemini/config` or GEMINI_API_KEY env |
|
|
76
63
|
| rtk-exec | RTK proxy running on localhost |
|
|
77
64
|
|
|
78
65
|
## Limitations
|
package/templates/manifest.json
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "0.
|
|
2
|
+
"version": "0.160.0",
|
|
3
3
|
"lastUpdated": "2026-05-20T00:00:00.000Z",
|
|
4
4
|
"omcustomMinClaudeCode": "2.1.121",
|
|
5
5
|
"omcustomMinClaudeCodeReason": "Sensitive-path direct Write/Edit on .claude/** under bypassPermissions (R010 deprecation, #1101)",
|
|
@@ -20,7 +20,7 @@
|
|
|
20
20
|
"name": "skills",
|
|
21
21
|
"path": ".claude/skills",
|
|
22
22
|
"description": "Reusable skill modules (includes slash commands)",
|
|
23
|
-
"files":
|
|
23
|
+
"files": 115
|
|
24
24
|
},
|
|
25
25
|
{
|
|
26
26
|
"name": "guides",
|