oh-my-customcode 0.33.1 → 0.35.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 +19 -19
- package/package.json +1 -1
- package/templates/.claude/hooks/hooks.json +10 -0
- package/templates/.claude/hooks/scripts/cost-cap-advisor.sh +71 -0
- package/templates/.claude/hooks/scripts/stuck-detector.sh +62 -2
- package/templates/.claude/hooks/scripts/task-outcome-recorder.sh +34 -7
- package/templates/.claude/rules/MUST-agent-design.md +2 -2
- package/templates/.claude/skills/analysis/SKILL.md +2 -2
- package/templates/.claude/skills/audit-agents/SKILL.md +1 -1
- package/templates/.claude/skills/create-agent/SKILL.md +1 -1
- package/templates/.claude/skills/dev-refactor/SKILL.md +76 -0
- package/templates/.claude/skills/dev-review/SKILL.md +76 -0
- package/templates/.claude/skills/evaluator-optimizer/SKILL.md +256 -0
- package/templates/.claude/skills/fix-refs/SKILL.md +1 -1
- package/templates/.claude/skills/help/SKILL.md +2 -2
- package/templates/.claude/skills/lists/SKILL.md +2 -2
- package/templates/.claude/skills/monitoring-setup/SKILL.md +1 -1
- package/templates/.claude/skills/npm-audit/SKILL.md +1 -1
- package/templates/.claude/skills/npm-publish/SKILL.md +1 -1
- package/templates/.claude/skills/npm-version/SKILL.md +1 -1
- package/templates/.claude/skills/research/SKILL.md +116 -0
- package/templates/.claude/skills/sauron-watch/SKILL.md +1 -1
- package/templates/.claude/skills/status/SKILL.md +2 -2
- package/templates/.claude/skills/task-decomposition/SKILL.md +13 -0
- package/templates/.claude/skills/update-docs/SKILL.md +1 -1
- package/templates/.claude/skills/update-external/SKILL.md +1 -1
- package/templates/.claude/skills/worker-reviewer-pipeline/SKILL.md +10 -0
- package/templates/.claude/statusline.sh +6 -0
- package/templates/CLAUDE.md.en +21 -21
- package/templates/CLAUDE.md.ko +21 -21
- package/templates/guides/claude-code/12-workflow-patterns.md +182 -0
- package/templates/manifest.json +3 -3
package/templates/CLAUDE.md.ko
CHANGED
|
@@ -151,31 +151,31 @@ oh-my-customcode로 구동됩니다.
|
|
|
151
151
|
|
|
152
152
|
| 커맨드 | 설명 |
|
|
153
153
|
|--------|------|
|
|
154
|
-
| `/analysis` | 프로젝트 분석 및 자동 커스터마이징 |
|
|
155
|
-
| `/create-agent` | 새 에이전트 생성 |
|
|
156
|
-
| `/update-docs` | 프로젝트 구조와 문서 동기화 |
|
|
157
|
-
| `/update-external` | 외부 소스에서 에이전트 업데이트 |
|
|
158
|
-
| `/audit-agents` | 에이전트 의존성 감사 |
|
|
159
|
-
| `/fix-refs` | 깨진 참조 수정 |
|
|
154
|
+
| `/omcustom:analysis` | 프로젝트 분석 및 자동 커스터마이징 |
|
|
155
|
+
| `/omcustom:create-agent` | 새 에이전트 생성 |
|
|
156
|
+
| `/omcustom:update-docs` | 프로젝트 구조와 문서 동기화 |
|
|
157
|
+
| `/omcustom:update-external` | 외부 소스에서 에이전트 업데이트 |
|
|
158
|
+
| `/omcustom:audit-agents` | 에이전트 의존성 감사 |
|
|
159
|
+
| `/omcustom:fix-refs` | 깨진 참조 수정 |
|
|
160
160
|
| `/dev-review` | 코드 베스트 프랙티스 리뷰 |
|
|
161
161
|
| `/dev-refactor` | 코드 리팩토링 |
|
|
162
162
|
| `/memory-save` | 세션 컨텍스트를 claude-mem에 저장 |
|
|
163
163
|
| `/memory-recall` | 메모리 검색 및 리콜 |
|
|
164
|
-
| `/monitoring-setup` | OTel 콘솔 모니터링 활성화/비활성화 |
|
|
165
|
-
| `/npm-publish` | npm 레지스트리에 패키지 배포 |
|
|
166
|
-
| `/npm-version` | 시맨틱 버전 관리 |
|
|
167
|
-
| `/npm-audit` | 의존성 감사 |
|
|
164
|
+
| `/omcustom:monitoring-setup` | OTel 콘솔 모니터링 활성화/비활성화 |
|
|
165
|
+
| `/omcustom:npm-publish` | npm 레지스트리에 패키지 배포 |
|
|
166
|
+
| `/omcustom:npm-version` | 시맨틱 버전 관리 |
|
|
167
|
+
| `/omcustom:npm-audit` | 의존성 감사 |
|
|
168
168
|
| `/codex-exec` | Codex CLI 프롬프트 실행 |
|
|
169
169
|
| `/optimize-analyze` | 번들 및 성능 분석 |
|
|
170
170
|
| `/optimize-bundle` | 번들 크기 최적화 |
|
|
171
171
|
| `/optimize-report` | 최적화 리포트 생성 |
|
|
172
172
|
| `/research` | 10-team 병렬 딥 분석 및 교차 검증 |
|
|
173
173
|
| `/deep-plan` | 연구 검증 기반 계획 수립 (research → plan → verify) |
|
|
174
|
-
| `/sauron-watch` | 전체 R017 검증 |
|
|
174
|
+
| `/omcustom:sauron-watch` | 전체 R017 검증 |
|
|
175
175
|
| `/structured-dev-cycle` | 6단계 구조적 개발 사이클 (Plan → Verify → Implement → Verify → Compound → Done) |
|
|
176
|
-
| `/lists` | 모든 사용 가능한 커맨드 표시 |
|
|
177
|
-
| `/status` | 시스템 상태 표시 |
|
|
178
|
-
| `/help` | 도움말 표시 |
|
|
176
|
+
| `/omcustom:lists` | 모든 사용 가능한 커맨드 표시 |
|
|
177
|
+
| `/omcustom:status` | 시스템 상태 표시 |
|
|
178
|
+
| `/omcustom:help` | 도움말 표시 |
|
|
179
179
|
|
|
180
180
|
## 프로젝트 구조
|
|
181
181
|
|
|
@@ -184,7 +184,7 @@ project/
|
|
|
184
184
|
+-- CLAUDE.md # 진입점
|
|
185
185
|
+-- .claude/
|
|
186
186
|
| +-- agents/ # 서브에이전트 정의 (44 파일)
|
|
187
|
-
| +-- skills/ # 스킬 (
|
|
187
|
+
| +-- skills/ # 스킬 (71 디렉토리)
|
|
188
188
|
| +-- rules/ # 전역 규칙 (R000-R019)
|
|
189
189
|
| +-- hooks/ # 훅 스크립트 (메모리, HUD)
|
|
190
190
|
| +-- contexts/ # 컨텍스트 파일 (ecomode)
|
|
@@ -250,15 +250,15 @@ Claude Code의 Agent Teams 기능이 활성화되어 있으면 (`CLAUDE_CODE_EXP
|
|
|
250
250
|
|
|
251
251
|
```bash
|
|
252
252
|
# 프로젝트 분석
|
|
253
|
-
/analysis
|
|
253
|
+
/omcustom:analysis
|
|
254
254
|
|
|
255
255
|
# 모든 커맨드 표시
|
|
256
|
-
/lists
|
|
256
|
+
/omcustom:lists
|
|
257
257
|
|
|
258
258
|
# 에이전트 관리
|
|
259
|
-
/create-agent my-agent
|
|
260
|
-
/update-docs
|
|
261
|
-
/audit-agents
|
|
259
|
+
/omcustom:create-agent my-agent
|
|
260
|
+
/omcustom:update-docs
|
|
261
|
+
/omcustom:audit-agents
|
|
262
262
|
|
|
263
263
|
# 코드 리뷰
|
|
264
264
|
/dev-review src/main.go
|
|
@@ -268,7 +268,7 @@ Claude Code의 Agent Teams 기능이 활성화되어 있으면 (`CLAUDE_CODE_EXP
|
|
|
268
268
|
/memory-recall authentication
|
|
269
269
|
|
|
270
270
|
# 검증
|
|
271
|
-
/sauron-watch
|
|
271
|
+
/omcustom:sauron-watch
|
|
272
272
|
```
|
|
273
273
|
|
|
274
274
|
## 외부 의존성
|
|
@@ -0,0 +1,182 @@
|
|
|
1
|
+
# 워크플로우 패턴
|
|
2
|
+
|
|
3
|
+
AI 에이전트 작업에 적합한 워크플로우 패턴 선택 가이드
|
|
4
|
+
|
|
5
|
+
## 패턴 분류
|
|
6
|
+
|
|
7
|
+
### 1. 순차 체인 (Sequential Chain)
|
|
8
|
+
|
|
9
|
+
**사용 시점**: 각 단계가 이전 출력에 의존하는 순서대로 실행해야 할 때
|
|
10
|
+
**프리미티브**: dag-orchestration (선형 모드)
|
|
11
|
+
**예시**: 입력 파싱 → 변환 → 검증 → 출력
|
|
12
|
+
|
|
13
|
+
```
|
|
14
|
+
[단계 1] 입력 파싱
|
|
15
|
+
↓
|
|
16
|
+
[단계 2] 데이터 변환
|
|
17
|
+
↓
|
|
18
|
+
[단계 3] 결과 검증
|
|
19
|
+
↓
|
|
20
|
+
[단계 4] 출력 생성
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
**적합한 경우**:
|
|
24
|
+
- 이전 단계 결과가 다음 단계 입력이 될 때
|
|
25
|
+
- 실패 시 롤백이 필요한 다단계 배포
|
|
26
|
+
- 순서가 보장되어야 하는 데이터 파이프라인
|
|
27
|
+
|
|
28
|
+
### 2. 병렬 팬아웃 (Parallel Fan-Out)
|
|
29
|
+
|
|
30
|
+
**사용 시점**: 공유 상태가 없는 독립적인 하위 작업들
|
|
31
|
+
**프리미티브**: Agent 도구 (R009) 또는 Agent Teams (R018)
|
|
32
|
+
**예시**: 4개 파일 동시 리뷰, 10개 주제 병렬 리서치
|
|
33
|
+
|
|
34
|
+
```
|
|
35
|
+
[오케스트레이터]
|
|
36
|
+
/ | \
|
|
37
|
+
[에이전트 1] [에이전트 2] [에이전트 3]
|
|
38
|
+
\ | /
|
|
39
|
+
[결과 집계]
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
**적합한 경우**:
|
|
43
|
+
- 파일 간 의존성이 없는 멀티파일 코드 리뷰
|
|
44
|
+
- 여러 주제의 병렬 리서치
|
|
45
|
+
- 독립적인 컴포넌트 생성
|
|
46
|
+
|
|
47
|
+
**에이전트 수에 따른 선택**:
|
|
48
|
+
|
|
49
|
+
| 에이전트 수 | 권장 방법 |
|
|
50
|
+
|------------|---------|
|
|
51
|
+
| 1-2개 | Agent 도구 (R009) |
|
|
52
|
+
| 3개 이상 | Agent Teams (R018) |
|
|
53
|
+
| 리뷰 사이클 포함 | Agent Teams (R018) |
|
|
54
|
+
|
|
55
|
+
### 3. 평가자-최적화기 (Evaluator-Optimizer)
|
|
56
|
+
|
|
57
|
+
**사용 시점**: 반복적인 개선이 필요한 품질 중요 출력
|
|
58
|
+
**프리미티브**: worker-reviewer-pipeline, evaluator-optimizer
|
|
59
|
+
**예시**: 코드 리뷰 → 수정 → 재리뷰 사이클
|
|
60
|
+
|
|
61
|
+
```
|
|
62
|
+
[구현자] → 초안 생성
|
|
63
|
+
↓
|
|
64
|
+
[리뷰어] → 이슈 발견
|
|
65
|
+
↓
|
|
66
|
+
[구현자] → 수정 적용
|
|
67
|
+
↓
|
|
68
|
+
[리뷰어] → 품질 검증 통과?
|
|
69
|
+
├─ NO → 재수정 (max_iterations 까지)
|
|
70
|
+
└─ YES → 완료
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
**적합한 경우**:
|
|
74
|
+
- 품질 기준이 명확한 코드 생성
|
|
75
|
+
- 문서 초안 작성 및 개선
|
|
76
|
+
- 반복적인 검증이 필요한 설계 결정
|
|
77
|
+
|
|
78
|
+
**필수 설정**: `max_iterations` 항상 지정 (무한 루프 방지)
|
|
79
|
+
|
|
80
|
+
### 4. 오케스트레이터-워커 (Orchestrator-Workers)
|
|
81
|
+
|
|
82
|
+
**사용 시점**: 중간 결과에 따라 동적 라우팅이 필요한 복잡한 다단계 작업
|
|
83
|
+
**프리미티브**: 라우팅 스킬 (secretary/dev-lead/de-lead/qa-lead)
|
|
84
|
+
**예시**: 사용자 요청 → 의도 감지 → 전문가 라우팅 → 결과 집계
|
|
85
|
+
|
|
86
|
+
```
|
|
87
|
+
[사용자 요청]
|
|
88
|
+
↓
|
|
89
|
+
[오케스트레이터]
|
|
90
|
+
├─ secretary-routing → mgr-*, sys-*
|
|
91
|
+
├─ dev-lead-routing → lang-*, be-*, fe-*
|
|
92
|
+
├─ de-lead-routing → de-*
|
|
93
|
+
└─ qa-lead-routing → qa-*
|
|
94
|
+
↓
|
|
95
|
+
[전문가 에이전트 실행]
|
|
96
|
+
↓
|
|
97
|
+
[결과 집계 → 사용자]
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
**적합한 경우**:
|
|
101
|
+
- 도메인 전문 지식이 필요한 작업
|
|
102
|
+
- 사전에 필요한 에이전트를 알 수 없는 동적 작업
|
|
103
|
+
- 여러 전문 분야에 걸친 복합 작업
|
|
104
|
+
|
|
105
|
+
## 패턴 선택 결정 트리
|
|
106
|
+
|
|
107
|
+
```
|
|
108
|
+
작업 수신
|
|
109
|
+
├── 단일 단계, 반복 불필요?
|
|
110
|
+
│ └── YES → 직접 실행 (패턴 불필요)
|
|
111
|
+
├── 독립적인 하위 작업 여러 개?
|
|
112
|
+
│ ├── YES, 1-2 에이전트 → 병렬 팬아웃 (Agent 도구)
|
|
113
|
+
│ └── YES, 3+ 에이전트 → 병렬 팬아웃 (Agent Teams)
|
|
114
|
+
├── 품질 중요 출력?
|
|
115
|
+
│ └── YES → 평가자-최적화기
|
|
116
|
+
├── 단계들이 서로 의존?
|
|
117
|
+
│ ├── 선형 의존 → 순차 체인
|
|
118
|
+
│ └── 복잡한 의존 → 오케스트레이터-워커
|
|
119
|
+
└── 동적 라우팅 필요?
|
|
120
|
+
└── YES → 오케스트레이터-워커
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
## 패턴 조합
|
|
124
|
+
|
|
125
|
+
복잡한 작업은 여러 패턴을 조합하여 구성할 수 있습니다.
|
|
126
|
+
|
|
127
|
+
| 조합 | 예시 |
|
|
128
|
+
|------|------|
|
|
129
|
+
| 병렬 + 평가자-최적화기 | 여러 파일 리뷰, 각각에 리뷰 사이클 적용 |
|
|
130
|
+
| 순차 + 병렬 | 파싱 → 병렬 처리 팬아웃 → 집계 |
|
|
131
|
+
| 오케스트레이터 + 평가자-최적화기 | 전문가 라우팅 → 전문가가 리뷰 사이클 사용 |
|
|
132
|
+
| 병렬 + 순차 | 독립 리서치 팀 → 순차 보고서 합성 |
|
|
133
|
+
|
|
134
|
+
## 안티패턴
|
|
135
|
+
|
|
136
|
+
| 안티패턴 | 문제점 | 수정 방법 |
|
|
137
|
+
|----------|--------|----------|
|
|
138
|
+
| 병렬화 가능한 작업을 순차 실행 | 시간 낭비 | R009 독립성 기준 확인 |
|
|
139
|
+
| 단순 쿼리에 10팀 리서치 적용 | 과도한 토큰 소비 | research "사용 금지 시점" 확인 |
|
|
140
|
+
| 종료 기준 없는 평가자-최적화기 루프 | 무한 반복 위험 | 항상 max_iterations 설정 |
|
|
141
|
+
| 결과 집계 없는 병렬 실행 | 결과 손실 | result-aggregation 스킬 사용 |
|
|
142
|
+
| 전문가가 있는데 general-purpose 사용 | 품질 저하 | R010 위임 규칙 확인 |
|
|
143
|
+
| 오케스트레이터가 직접 파일 수정 | R010 위반 | 전문 에이전트에 위임 |
|
|
144
|
+
|
|
145
|
+
## 비용 고려사항
|
|
146
|
+
|
|
147
|
+
| 패턴 | 상대 비용 | 적합한 시점 |
|
|
148
|
+
|------|----------|------------|
|
|
149
|
+
| 직접 실행 | $ | 단순 작업 |
|
|
150
|
+
| 순차 체인 | $$ | 의존적인 단계들 |
|
|
151
|
+
| 병렬 (2-4 에이전트) | $$$ | 시간 중요 독립 작업 |
|
|
152
|
+
| 평가자-최적화기 (3-5회 반복) | $$$$ | 품질 중요 결과물 |
|
|
153
|
+
| 전체 리서치 (10팀) | $$$$$ | 포괄적 커버리지가 필요한 복잡한 분석 |
|
|
154
|
+
|
|
155
|
+
### 비용 최적화 원칙
|
|
156
|
+
|
|
157
|
+
```
|
|
158
|
+
탐색 → haiku (파일 검색, 구조 파악)
|
|
159
|
+
구현 → sonnet (코딩, 문서 작성)
|
|
160
|
+
판단 → opus (아키텍처 결정, 복잡한 리뷰)
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
## oh-my-customcode 패턴 매핑
|
|
164
|
+
|
|
165
|
+
| 패턴 | oh-my-customcode 프리미티브 | 규칙 |
|
|
166
|
+
|------|---------------------------|------|
|
|
167
|
+
| 순차 체인 | dag-orchestration (linear) | R010 |
|
|
168
|
+
| 병렬 팬아웃 (소규모) | Agent 도구 | R009 |
|
|
169
|
+
| 병렬 팬아웃 (대규모) | Agent Teams | R018 |
|
|
170
|
+
| 평가자-최적화기 | worker-reviewer-pipeline | R009, R018 |
|
|
171
|
+
| 오케스트레이터-워커 | Routing 스킬 | R010, R015 |
|
|
172
|
+
| 리서치 | /research (10팀 병렬) | R009, R018 |
|
|
173
|
+
| 계획 수립 | /deep-plan (research → plan → verify) | R009, R018 |
|
|
174
|
+
|
|
175
|
+
## 참고 문서
|
|
176
|
+
|
|
177
|
+
- R009: Parallel Execution Rules
|
|
178
|
+
- R010: Orchestrator Coordination Rules
|
|
179
|
+
- R018: Agent Teams Rules
|
|
180
|
+
- `.claude/skills/dag-orchestration/SKILL.md`
|
|
181
|
+
- `.claude/skills/worker-reviewer-pipeline/SKILL.md`
|
|
182
|
+
- `.claude/skills/task-decomposition/SKILL.md`
|
package/templates/manifest.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "0.
|
|
3
|
-
"lastUpdated": "2026-03-
|
|
2
|
+
"version": "0.35.0",
|
|
3
|
+
"lastUpdated": "2026-03-14T00:00:00.000Z",
|
|
4
4
|
"components": [
|
|
5
5
|
{
|
|
6
6
|
"name": "rules",
|
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
"name": "skills",
|
|
19
19
|
"path": ".claude/skills",
|
|
20
20
|
"description": "Reusable skill modules (includes slash commands)",
|
|
21
|
-
"files":
|
|
21
|
+
"files": 71
|
|
22
22
|
},
|
|
23
23
|
{
|
|
24
24
|
"name": "guides",
|