oh-my-customcode 0.33.0 → 0.34.0

package/templates/guides/claude-code/12-workflow-patterns.md

@@ -0,0 +1,182 @@
+# 워크플로우 패턴
+
+AI 에이전트 작업에 적합한 워크플로우 패턴 선택 가이드
+
+## 패턴 분류
+
+### 1. 순차 체인 (Sequential Chain)
+
+**사용 시점**: 각 단계가 이전 출력에 의존하는 순서대로 실행해야 할 때
+**프리미티브**: dag-orchestration (선형 모드)
+**예시**: 입력 파싱 → 변환 → 검증 → 출력
+
+```
+[단계 1] 입력 파싱
+    ↓
+[단계 2] 데이터 변환
+    ↓
+[단계 3] 결과 검증
+    ↓
+[단계 4] 출력 생성
+```
+
+**적합한 경우**:
+- 이전 단계 결과가 다음 단계 입력이 될 때
+- 실패 시 롤백이 필요한 다단계 배포
+- 순서가 보장되어야 하는 데이터 파이프라인
+
+### 2. 병렬 팬아웃 (Parallel Fan-Out)
+
+**사용 시점**: 공유 상태가 없는 독립적인 하위 작업들
+**프리미티브**: Agent 도구 (R009) 또는 Agent Teams (R018)
+**예시**: 4개 파일 동시 리뷰, 10개 주제 병렬 리서치
+
+```
+                [오케스트레이터]
+               /       |        \
+    [에이전트 1] [에이전트 2] [에이전트 3]
+               \       |        /
+                [결과 집계]
+```
+
+**적합한 경우**:
+- 파일 간 의존성이 없는 멀티파일 코드 리뷰
+- 여러 주제의 병렬 리서치
+- 독립적인 컴포넌트 생성
+
+**에이전트 수에 따른 선택**:
+
+| 에이전트 수 | 권장 방법 |
+|------------|---------|
+| 1-2개 | Agent 도구 (R009) |
+| 3개 이상 | Agent Teams (R018) |
+| 리뷰 사이클 포함 | Agent Teams (R018) |
+
+### 3. 평가자-최적화기 (Evaluator-Optimizer)
+
+**사용 시점**: 반복적인 개선이 필요한 품질 중요 출력
+**프리미티브**: worker-reviewer-pipeline, evaluator-optimizer
+**예시**: 코드 리뷰 → 수정 → 재리뷰 사이클
+
+```
+[구현자] → 초안 생성
+    ↓
+[리뷰어] → 이슈 발견
+    ↓
+[구현자] → 수정 적용
+    ↓
+[리뷰어] → 품질 검증 통과?
+    ├─ NO  → 재수정 (max_iterations 까지)
+    └─ YES → 완료
+```
+
+**적합한 경우**:
+- 품질 기준이 명확한 코드 생성
+- 문서 초안 작성 및 개선
+- 반복적인 검증이 필요한 설계 결정
+
+**필수 설정**: `max_iterations` 항상 지정 (무한 루프 방지)
+
+### 4. 오케스트레이터-워커 (Orchestrator-Workers)
+
+**사용 시점**: 중간 결과에 따라 동적 라우팅이 필요한 복잡한 다단계 작업
+**프리미티브**: 라우팅 스킬 (secretary/dev-lead/de-lead/qa-lead)
+**예시**: 사용자 요청 → 의도 감지 → 전문가 라우팅 → 결과 집계
+
+```
+[사용자 요청]
+    ↓
+[오케스트레이터]
+    ├─ secretary-routing → mgr-*, sys-*
+    ├─ dev-lead-routing  → lang-*, be-*, fe-*
+    ├─ de-lead-routing   → de-*
+    └─ qa-lead-routing   → qa-*
+         ↓
+[전문가 에이전트 실행]
+    ↓
+[결과 집계 → 사용자]
+```
+
+**적합한 경우**:
+- 도메인 전문 지식이 필요한 작업
+- 사전에 필요한 에이전트를 알 수 없는 동적 작업
+- 여러 전문 분야에 걸친 복합 작업
+
+## 패턴 선택 결정 트리
+
+```
+작업 수신
+├── 단일 단계, 반복 불필요?
+│   └── YES → 직접 실행 (패턴 불필요)
+├── 독립적인 하위 작업 여러 개?
+│   ├── YES, 1-2 에이전트 → 병렬 팬아웃 (Agent 도구)
+│   └── YES, 3+ 에이전트 → 병렬 팬아웃 (Agent Teams)
+├── 품질 중요 출력?
+│   └── YES → 평가자-최적화기
+├── 단계들이 서로 의존?
+│   ├── 선형 의존 → 순차 체인
+│   └── 복잡한 의존 → 오케스트레이터-워커
+└── 동적 라우팅 필요?
+    └── YES → 오케스트레이터-워커
+```
+
+## 패턴 조합
+
+복잡한 작업은 여러 패턴을 조합하여 구성할 수 있습니다.
+
+| 조합 | 예시 |
+|------|------|
+| 병렬 + 평가자-최적화기 | 여러 파일 리뷰, 각각에 리뷰 사이클 적용 |
+| 순차 + 병렬 | 파싱 → 병렬 처리 팬아웃 → 집계 |
+| 오케스트레이터 + 평가자-최적화기 | 전문가 라우팅 → 전문가가 리뷰 사이클 사용 |
+| 병렬 + 순차 | 독립 리서치 팀 → 순차 보고서 합성 |
+
+## 안티패턴
+
+| 안티패턴 | 문제점 | 수정 방법 |
+|----------|--------|----------|
+| 병렬화 가능한 작업을 순차 실행 | 시간 낭비 | R009 독립성 기준 확인 |
+| 단순 쿼리에 10팀 리서치 적용 | 과도한 토큰 소비 | research "사용 금지 시점" 확인 |
+| 종료 기준 없는 평가자-최적화기 루프 | 무한 반복 위험 | 항상 max_iterations 설정 |
+| 결과 집계 없는 병렬 실행 | 결과 손실 | result-aggregation 스킬 사용 |
+| 전문가가 있는데 general-purpose 사용 | 품질 저하 | R010 위임 규칙 확인 |
+| 오케스트레이터가 직접 파일 수정 | R010 위반 | 전문 에이전트에 위임 |
+
+## 비용 고려사항
+
+| 패턴 | 상대 비용 | 적합한 시점 |
+|------|----------|------------|
+| 직접 실행 | $ | 단순 작업 |
+| 순차 체인 | $$ | 의존적인 단계들 |
+| 병렬 (2-4 에이전트) | $$$ | 시간 중요 독립 작업 |
+| 평가자-최적화기 (3-5회 반복) | $$$$ | 품질 중요 결과물 |
+| 전체 리서치 (10팀) | $$$$$ | 포괄적 커버리지가 필요한 복잡한 분석 |
+
+### 비용 최적화 원칙
+
+```
+탐색 → haiku  (파일 검색, 구조 파악)
+구현 → sonnet (코딩, 문서 작성)
+판단 → opus   (아키텍처 결정, 복잡한 리뷰)
+```
+
+## oh-my-customcode 패턴 매핑
+
+| 패턴 | oh-my-customcode 프리미티브 | 규칙 |
+|------|---------------------------|------|
+| 순차 체인 | dag-orchestration (linear) | R010 |
+| 병렬 팬아웃 (소규모) | Agent 도구 | R009 |
+| 병렬 팬아웃 (대규모) | Agent Teams | R018 |
+| 평가자-최적화기 | worker-reviewer-pipeline | R009, R018 |
+| 오케스트레이터-워커 | Routing 스킬 | R010, R015 |
+| 리서치 | /research (10팀 병렬) | R009, R018 |
+| 계획 수립 | /deep-plan (research → plan → verify) | R009, R018 |
+
+## 참고 문서
+
+- R009: Parallel Execution Rules
+- R010: Orchestrator Coordination Rules
+- R018: Agent Teams Rules
+- `.claude/skills/dag-orchestration/SKILL.md`
+- `.claude/skills/worker-reviewer-pipeline/SKILL.md`
+- `.claude/skills/task-decomposition/SKILL.md`

package/templates/manifest.json

@@ -1,6 +1,6 @@
 {
-  "version": "0.33.0",
-  "lastUpdated": "2026-03-13T00:00:00.000Z",
+  "version": "0.34.0",
+  "lastUpdated": "2026-03-14T00:00:00.000Z",
   "components": [
     {
       "name": "rules",
@@ -18,7 +18,7 @@
       "name": "skills",
       "path": ".claude/skills",
       "description": "Reusable skill modules (includes slash commands)",
-      "files": 69
+      "files": 71
     },
     {
       "name": "guides",