oh-my-customcodex 0.1.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-customcodex 패턴 매핑
+
+| 패턴 | oh-my-customcodex 프리미티브 | 규칙 |
+|------|---------------------------|------|
+| 순차 체인 | 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/guides/claude-code/13-cli-flags.md

@@ -0,0 +1,151 @@
+# Claude Code CLI Flags & Modes
+
+## CLI Flags Reference
+
+| Flag | Description | Example |
+|------|------------|---------|
+| `--worktree` | Run in isolated git worktree | `claude --worktree "fix bug"` |
+| `--remote` | Connect to remote Claude Code instance | `claude --remote` |
+| `--bare` | Minimal UI, no statusline | `claude --bare` |
+| `--agent <name>` | Use specific agent as main thread | `claude --agent lang-golang-expert` |
+| `--agents` | List available agents | `claude --agents` |
+| `--from-pr <url>` | Start from a pull request | `claude --from-pr https://github.com/org/repo/pull/123` |
+| `--chrome` | Enable Chrome browser automation | `claude --chrome` |
+| `--json-schema` | Output JSON schema for structured output | `claude --json-schema schema.json` |
+| `--max-budget-usd <n>` | Set maximum spend cap | `claude --max-budget-usd 5.00` |
+| `--fallback-model <id>` | Model to use when primary unavailable | `claude --fallback-model claude-sonnet-4-6` |
+| `--fork-session` | Fork an existing session | `claude --fork-session` |
+| `--teleport` | Transfer session context to another terminal | `claude --teleport` |
+
+## Headless Mode (`claude -p`)
+
+Headless mode runs Claude Code non-interactively, useful for CI/CD pipelines and automated workflows.
+
+```bash
+# Basic pipe mode
+echo "explain this code" | claude -p
+
+# With JSON output
+echo "list all TODOs" | claude -p --output-format json
+
+# Stream JSON events
+echo "refactor this function" | claude -p --output-format stream-json
+
+# With specific model
+echo "review PR" | claude -p --model claude-sonnet-4-6
+```
+
+### Output Formats
+
+| Format | Flag | Description |
+|--------|------|-------------|
+| Text | (default) | Plain text output |
+| JSON | `--output-format json` | Structured JSON response |
+| Stream JSON | `--output-format stream-json` | Newline-delimited JSON events |
+
+### CI Integration
+
+```yaml
+# GitHub Actions example
+- name: Claude Code Review
+  run: echo "Review this PR for security issues" | claude -p --max-budget-usd 2.00
+  env:
+    ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+```
+
+## Scheduled Agents (CronCreate)
+
+Claude Code supports native scheduled agents via `CronCreate`, `CronDelete`, and `CronList` tools.
+
+```bash
+# Create a scheduled agent
+# CronCreate(schedule: "0 9 * * 1-5", prompt: "check for stale PRs", name: "pr-checker")
+
+# List scheduled agents
+# CronList()
+
+# Delete a scheduled agent
+# CronDelete(name: "pr-checker")
+```
+
+### Schedule Format
+
+Standard cron syntax: `minute hour day-of-month month day-of-week`
+
+| Pattern | Description |
+|---------|-------------|
+| `0 9 * * 1-5` | Weekdays at 9:00 AM |
+| `0 */6 * * *` | Every 6 hours |
+| `0 0 * * 0` | Weekly on Sunday midnight |
+
+### RemoteTrigger
+
+For on-demand execution of scheduled agents:
+
+```bash
+# Trigger a scheduled agent immediately
+# RemoteTrigger(name: "pr-checker")
+```
+
+## Auto Mode Configuration
+
+Auto mode allows Claude Code to make decisions about tool permissions autonomously.
+
+### Settings
+
+```json
+{
+  "autoMode": {
+    "environment": "local",
+    "allow": ["Read", "Write", "Edit", "Glob", "Grep"],
+    "soft_deny": ["Bash(rm *)", "Bash(git push --force)"]
+  }
+}
+```
+
+### CLI Commands
+
+```bash
+claude auto-mode defaults    # Show default auto mode settings
+claude auto-mode config      # Configure auto mode
+claude auto-mode critique    # Review auto mode decisions
+```
+
+| Field | Description |
+|-------|-------------|
+| `environment` | Execution context (`local`, `ci`, `container`) |
+| `allow` | Tools auto-approved without prompting |
+| `soft_deny` | Tool patterns that trigger warning before execution |
+
+## Environment Variables
+
+### Model & Behavior
+
+| Variable | Description | Example |
+|----------|-------------|---------|
+| `ANTHROPIC_MODEL` | Override default model | `claude-opus-4-6` |
+| `CLAUDE_CODE_SUBAGENT_MODEL` | Override subagent model | `claude-haiku-4-5` |
+| `CLAUDE_CODE_EFFORT_LEVEL` | Set effort level | `high` |
+| `CLAUDE_CODE_DISABLE_FAST_MODE` | Disable fast mode | `1` |
+
+### Agent Teams
+
+| Variable | Description |
+|----------|-------------|
+| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Enable Agent Teams (`1`) |
+
+### Data Privacy
+
+| Variable | Description |
+|----------|-------------|
+| `DISABLE_TELEMETRY` | Disable all telemetry collection |
+| `DISABLE_ERROR_REPORTING` | Disable error reporting to Anthropic |
+| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Disable non-essential network traffic |
+| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Disable feedback survey prompts |
+| `DO_NOT_TRACK` | Standard DNT signal — disables tracking |
+
+## Related
+
+- [Monitoring Guide](10-monitoring.md) — OTel metrics and events
+- [Sub-agents Guide](11-sub-agents.md) — Agent spawning and coordination
+- [Workflow Patterns](12-workflow-patterns.md) — Workflow automation

package/templates/guides/claude-code/index.yaml

@@ -0,0 +1,61 @@
+# Claude Code Guide Index
+# Claude로 에이전트를 구축하기 위한 가이드 문서 인덱스
+
+documents:
+  - name: overview
+    title: 기능 개요
+    description: Claude의 핵심 기능 및 도구 요약
+    path: ./01-overview.md
+
+  - name: tools
+    title: 도구 사용
+    description: Claude와 도구 통합 방법
+    path: ./03-tools.md
+
+  - name: agent-skills
+    title: 에이전트 스킬
+    description: Skills로 Claude 기능 확장
+    path: ./04-agent-skills.md
+
+  - name: agent-sdk
+    title: 에이전트 SDK
+    description: Python/TypeScript로 에이전트 구축
+    path: ./05-agent-sdk.md
+
+  - name: mcp
+    title: MCP 커넥터
+    description: Model Context Protocol 서버 연결
+    path: ./06-mcp.md
+
+  - name: prompt-engineering
+    title: 프롬프트 엔지니어링
+    description: 프롬프트 최적화 기법
+    path: ./07-prompt-engineering.md
+
+  - name: testing
+    title: 테스트 및 평가
+    description: 품질 보장을 위한 테스트 방법
+    path: ./08-testing.md
+    status: placeholder  # 공식 문서 미공개
+
+  - name: guardrails
+    title: 가드레일 강화
+    description: 안전한 에이전트 운영을 위한 제약
+    path: ./09-guardrails.md
+    status: placeholder  # 공식 문서 미공개
+
+  - name: monitoring
+    title: 관리 및 모니터링
+    description: 프로덕션 에이전트 운영
+    path: ./10-monitoring.md
+    status: placeholder  # 공식 문서 미공개
+
+  - name: workflow-patterns
+    title: 워크플로우 패턴
+    description: AI 에이전트 작업에 적합한 워크플로우 패턴 선택 가이드
+    path: ./12-workflow-patterns.md
+
+  - name: cli-flags
+    title: CLI 플래그 및 모드
+    description: CLI 플래그, 헤드리스 모드, 스케줄링, 환경변수 레퍼런스
+    path: ./13-cli-flags.md

package/templates/guides/dbt/README.md

@@ -0,0 +1,32 @@
+# dbt Guide
+
+Reference documentation for dbt SQL modeling and analytics engineering best practices.
+
+## Source
+
+Based on [dbt Labs official documentation](https://docs.getdbt.com/) and dbt best practices guides.
+
+## Categories
+
+| Priority | Category | Impact |
+|----------|----------|--------|
+| 1 | Project Structure | CRITICAL |
+| 2 | Modeling Patterns | CRITICAL |
+| 3 | Testing | HIGH |
+| 4 | Materializations | HIGH |
+| 5 | Documentation | MEDIUM |
+| 6 | Macros & Jinja | MEDIUM |
+| 7 | Deployment & CI | LOW-MEDIUM |
+
+## Usage
+
+This guide is referenced by:
+- **Agent**: de-dbt-expert
+- **Skill**: dbt-best-practices
+
+## External Resources
+
+- [dbt Docs](https://docs.getdbt.com/)
+- [dbt Best Practices](https://docs.getdbt.com/best-practices)
+- [dbt Style Guide](https://github.com/dbt-labs/corp/blob/main/dbt_style_guide.md)
+- [dbt Learn](https://courses.getdbt.com/)