oh-my-customcodex 0.1.0

package/templates/CLAUDE.md.ko

@@ -0,0 +1,256 @@
+# AI 에이전트 시스템
+
+oh-my-customcodex로 구동됩니다.
+
+---
+## 모든 응답 전 반드시 확인
+
+1. 에이전트 식별로 시작하는가? (R007) 2. 도구 호출에 식별 포함? (R008) 3. 2+ 에이전트 스폰 시 R018 체크? → 하나라도 NO면 즉시 수정
+
+---
+
+## 중요: 규칙 적용 범위
+
+> **이 규칙들은 상황에 관계없이 항상 적용됩니다:**
+
+| 상황 | 규칙 적용? |
+|------|-----------|
+| 이 프로젝트 작업 시 | **예** |
+| 외부 프로젝트 작업 시 | **예** |
+| 컨텍스트 압축 후 | **예** |
+| 간단한 질문 | **예** |
+| 모든 상황 | **예** |
+
+---
+
+## 중요: 세션 연속성
+
+> **이 규칙들은 컨텍스트 압축 후에도 항상 적용됩니다.**
+
+```
+"compact conversation" 후 세션이 계속될 때:
+1. 이 AGENTS.md를 즉시 다시 읽기
+2. 모든 강제 규칙 활성 상태 유지
+3. 이전 컨텍스트 요약이 이 규칙을 대체하지 않음
+4. 첫 응답은 반드시 에이전트 식별 포함
+
+예외 없음. 변명 없음.
+```
+
+---
+
+## 중요: 강제 규칙
+
+> **이 규칙들은 협상 불가. 위반 = 즉시 수정 필요.**
+
+| 규칙 | 핵심 | 위반 시 |
+|------|------|--------|
+| R007 에이전트 식별 | 모든 응답은 `┌─ Agent:` 헤더로 시작 | 즉시 헤더 추가 |
+| R008 도구 식별 | 모든 도구 호출에 `[에이전트명][모델] → Tool:` 접두사 | 즉시 접두사 추가 |
+| R009 병렬 실행 | 독립 작업 2개 이상 → 병렬 에이전트 (최대 4개) | 순차 실행 중단, 병렬로 전환 |
+| R010 오케스트레이터 | 오케스트레이터는 파일 수정 금지 → 서브에이전트에 위임 | 직접 수정 중단, 위임 |
+
+---
+
+## 전역 규칙 (필수 준수)
+
+> `.codex/rules/` 참조
+
+### MUST (절대 위반 금지)
+| ID | 규칙 | 설명 |
+|----|------|------|
+| R000 | 언어 정책 | 한국어 입출력, 영어 파일, 위임 모델 |
+| R001 | 안전 규칙 | 금지된 작업, 필수 확인 |
+| R002 | 권한 규칙 | 도구 티어, 파일 접근 범위 |
+| R006 | 에이전트 설계 | 에이전트 구조, 관심사 분리 |
+| R007 | 에이전트 식별 | **강제** - 모든 응답에 에이전트/스킬 표시 |
+| R008 | 도구 식별 | **강제** - 모든 도구 사용 시 에이전트 표시 |
+| R009 | 병렬 실행 | **강제** - 병렬 실행, 대규모 작업 분해 |
+| R010 | 오케스트레이터 조율 | **강제** - 오케스트레이터 조율, 세션 연속성, 직접 실행 금지 |
+| R015 | 의도 투명성 | **강제** - 투명한 에이전트 라우팅 |
+| R016 | 지속적 개선 | **강제** - 위반 발생 시 규칙 업데이트 |
+| R017 | 동기화 검증 | **강제** - 구조 변경 전 검증 |
+| R018 | Agent Teams | **강제(조건부)** - Agent Teams 활성화 시 적합한 작업에 필수 사용 |
+| R020 | 완료 검증 | **강제** - 작업 완료 선언 전 검증 필수 |
+
+### SHOULD (강력 권장)
+| ID | 규칙 | 설명 |
+|----|------|------|
+| R003 | 상호작용 규칙 | 응답 원칙, 상태 형식 |
+| R004 | 오류 처리 | 오류 수준, 복구 전략 |
+| R011 | 메모리 통합 | omx-memory을 통한 세션 지속성 |
+| R012 | HUD 상태줄 | 실시간 상태 표시 |
+| R013 | Ecomode | 배치 작업 토큰 효율성 |
+| R019 | Ontology-RAG 라우팅 | 라우팅 스킬의 ontology-RAG enrichment |
+
+### MAY (선택)
+| ID | 규칙 | 설명 |
+|----|------|------|
+| R005 | 최적화 | 효율성, 토큰 최적화 |
+
+## 커맨드
+
+### 슬래시 커맨드 (스킬 기반)
+
+| 커맨드 | 설명 |
+|--------|------|
+| `/omcodex:analysis` | 프로젝트 분석 및 자동 커스터마이징 |
+| `/idea` | 자연어 아이디어를 구조화된 이슈 스펙으로 변환 |
+| `/omcodex:create-agent` | 새 에이전트 생성 |
+| `/omcodex:update-docs` | 프로젝트 구조와 문서 동기화 |
+| `/omcodex:update-external` | 외부 소스에서 에이전트 업데이트 |
+| `/omcodex:audit-agents` | 에이전트 의존성 감사 |
+| `/omcodex:fix-refs` | 깨진 참조 수정 |
+| `/omcodex:takeover` | 기존 에이전트/스킬에서 canonical spec 추출 |
+| `/dev-review` | 코드 베스트 프랙티스 리뷰 |
+| `/dev-refactor` | 코드 리팩토링 |
+| `/memory-save` | 세션 컨텍스트를 omx-memory에 저장 |
+| `/memory-recall` | 메모리 검색 및 리콜 |
+| `/omcodex:monitoring-setup` | OTel 콘솔 모니터링 활성화/비활성화 |
+| `/omcodex:npm-publish` | npm 레지스트리에 패키지 배포 |
+| `/omcodex:npm-version` | 시맨틱 버전 관리 |
+| `/omcodex:npm-audit` | 의존성 감사 |
+| `/omcodex-release-notes` | 릴리즈 노트 생성 (git 히스토리 기반) |
+| `/codex-exec` | Codex CLI 프롬프트 실행 |
+| `/optimize-analyze` | 번들 및 성능 분석 |
+| `/optimize-bundle` | 번들 크기 최적화 |
+| `/optimize-report` | 최적화 리포트 생성 |
+| `/research` | 10-team 병렬 딥 분석 및 교차 검증 |
+| `/deep-plan` | 연구 검증 기반 계획 수립 (research → plan → verify) |
+| `/omcodex:sauron-watch` | 전체 R017 검증 |
+| `/structured-dev-cycle` | 6단계 구조적 개발 사이클 (Plan → Verify → Implement → Verify → Compound → Done) |
+| `/omcodex:lists` | 모든 사용 가능한 커맨드 표시 |
+| `/omcodex:status` | 시스템 상태 표시 |
+| `/omcodex:help` | 도움말 표시 |
+
+## 프로젝트 구조
+
+```
+project/
++-- AGENTS.md                    # 진입점
++-- .codex/
+|   +-- agents/                  # 서브에이전트 정의 (48 파일)
+|   +-- skills/                  # 스킬 (106 디렉토리)
+|   +-- rules/                   # 전역 규칙 (22 파일)
+|   +-- hooks/                   # 훅 스크립트 (보안, 검증, HUD)
+|   +-- contexts/                # 컨텍스트 파일 (4 파일)
++-- guides/                      # 레퍼런스 문서 (38 토픽)
+```
+
+## 오케스트레이션
+
+오케스트레이션은 메인 대화의 라우팅 스킬로 처리됩니다:
+- **secretary-routing**: 매니저 에이전트로 관리 작업 라우팅
+- **dev-lead-routing**: 언어/프레임워크 전문가에게 개발 작업 라우팅
+- **de-lead-routing**: 데이터 엔지니어링 작업을 DE/파이프라인 전문가에게 라우팅
+- **qa-lead-routing**: QA 워크플로우 조율
+
+메인 대화가 유일한 오케스트레이터 역할을 합니다. 서브에이전트는 다른 서브에이전트를 생성할 수 없습니다.
+
+### 동적 에이전트 생성
+
+기존 에이전트 중 작업에 맞는 전문가가 없으면 자동으로 생성합니다:
+
+1. 라우팅 스킬이 매칭 전문가 없음을 감지
+2. 오케스트레이터가 mgr-creator에 컨텍스트와 함께 위임
+3. mgr-creator가 관련 skills/guides를 자동 탐색
+4. 새 에이전트 생성 후 즉시 사용
+
+이것이 oh-my-customcodex의 핵심 철학입니다: **"전문가가 없으면? 만들고, 지식을 연결하고, 사용한다."**
+
+## 에이전트 요약
+
+| 타입 | 수량 | 에이전트 |
+|------|------|----------|
+| SW Engineer/Language | 6 | lang-golang-expert, lang-python-expert, lang-rust-expert, lang-kotlin-expert, lang-typescript-expert, lang-java21-expert |
+| SW Engineer/Backend | 6 | be-fastapi-expert, be-springboot-expert, be-go-backend-expert, be-express-expert, be-nestjs-expert, be-django-expert |
+| SW Engineer/Frontend | 5 | fe-vercel-agent, fe-vuejs-agent, fe-svelte-agent, fe-flutter-agent, fe-design-expert |
+| SW Engineer/Tooling | 4 | tool-npm-expert, tool-optimizer, tool-bun-expert, slack-cli-expert |
+| DE Engineer | 6 | de-airflow-expert, de-dbt-expert, de-spark-expert, de-kafka-expert, de-snowflake-expert, de-pipeline-expert |
+| SW Engineer/Database | 4 | db-supabase-expert, db-postgres-expert, db-redis-expert, db-alembic-expert |
+| Security | 1 | sec-codeql-expert |
+| SW Architect | 2 | arch-documenter, arch-speckit-agent |
+| Infra Engineer | 2 | infra-docker-expert, infra-aws-expert |
+| QA Team | 3 | qa-planner, qa-writer, qa-engineer |
+| Manager | 6 | mgr-creator, mgr-updater, mgr-supplier, mgr-gitnerd, mgr-sauron, mgr-claude-code-bible |
+| System | 3 | sys-memory-keeper, sys-naggy, wiki-curator |
+| 보조 | 1 | slack-cli-expert |
+| **총계** | **48** | |
+
+## Agent Teams (MUST when enabled)
+
+Codex CLI의 Agent Teams 기능이 활성화되어 있으면 (`OMCODEX_AGENT_TEAMS=1`), 적격한 작업에 적극적으로 사용합니다.
+
+| 기능 | 서브에이전트 (기본) | Agent Teams |
+|------|---------------------|-------------|
+| 통신 | 호출자에게 결과만 반환 | 피어 투 피어 메시지 |
+| 조율 | 오케스트레이터가 관리 | 공유 작업 목록 |
+| 적합한 작업 | 집중된 작업 | 리서치, 리뷰, 디버깅 |
+| 토큰 비용 | 낮음 | 높음 |
+
+**활성화 시, 적격한 협업 작업에 Agent Teams를 반드시 사용해야 합니다 (R018 MUST).**
+결정 매트릭스는 R018 (MUST-agent-teams.md)을 참조하세요.
+하이브리드 패턴 (Claude + Codex, 동적 생성 + Teams)이 지원됩니다.
+단순/비용 민감 작업에는 Task tool + 라우팅 스킬이 폴백으로 유지됩니다.
+
+## 빠른 참조
+
+```bash
+# 프로젝트 분석
+/omcodex:analysis
+
+# 모든 커맨드 표시
+/omcodex:lists
+
+# 에이전트 관리
+/omcodex:create-agent my-agent
+/omcodex:update-docs
+/omcodex:audit-agents
+
+# 코드 리뷰
+/dev-review src/main.go
+
+# 메모리 관리
+/memory-save
+/memory-recall authentication
+
+# 검증
+/omcodex:sauron-watch
+```
+
+## 외부 의존성
+
+### 필수 플러그인
+
+`/plugin install <이름>`으로 설치:
+
+| 플러그인 | 소스 | 용도 |
+|----------|------|------|
+| superpowers | claude-plugins-official | TDD, 디버깅, 협업 패턴 |
+| openai-docs | superpowers-marketplace | Codex CLI 개발 문서 |
+| elements-of-style | superpowers-marketplace | 글쓰기 명확성 가이드라인 |
+| obsidian-skills | - | 옵시디언 마크다운 지원 |
+| context7 | claude-plugins-official | 라이브러리 문서 조회 |
+
+### 권장 MCP 서버
+
+| 서버 | 용도 |
+|------|------|
+| omx-memory | 세션 메모리 영속성 |
+
+### 설치 명령어
+
+```bash
+# 마켓플레이스 추가
+/plugin marketplace add obra/superpowers-marketplace
+
+# 플러그인 설치
+/plugin install superpowers
+/plugin install openai-docs
+/plugin install elements-of-style
+
+# MCP 설정 (omx-memory)
+omx memory doctor
+```
+
+<!-- omcodex:git-workflow -->

package/templates/deprecated-files.json

@@ -0,0 +1,10 @@
+{
+  "description": "Files deprecated or renamed in this version. These will be removed during omcustom update.",
+  "files": [
+    {
+      "path": ".claude/rules/SHOULD-agent-teams.md",
+      "reason": "Renamed to MUST-agent-teams.md",
+      "since": "0.17.0"
+    }
+  ]
+}

package/templates/guides/agents-md-quality/README.md

@@ -0,0 +1,110 @@
+# Agent Definition Quality Standards
+
+## Overview
+
+Quality criteria for `.claude/agents/*.md` files. Adapted from ETH Zurich research on LLM-generated agent configurations, modified to fit oh-my-customcodex's "create, connect, use" philosophy.
+
+## Core Principle: LLM Generation + Human Verification
+
+> ETH Zurich finding: Purely LLM-generated AGENTS.md files perform worse than human-crafted ones.
+>
+> oh-my-customcodex adaptation: LLM generation is the core workflow (via mgr-creator), but **verification is mandatory**. The creation tool generates; the verification process validates.
+
+| Approach | Status |
+|----------|--------|
+| Pure LLM generation without review | Not recommended |
+| LLM generation + mgr-sauron verification | Required (current workflow) |
+| Human-crafted from scratch | Acceptable but not required |
+
+## Four-Section Structure
+
+Every agent file SHOULD contain these conceptual sections:
+
+### 1. STYLE — How the agent communicates
+
+```yaml
+# In frontmatter or body
+# - Output format preferences
+# - Verbosity level (maps to effort: low/medium/high)
+# - Language conventions
+```
+
+### 2. GOTCHAS — Known pitfalls and edge cases
+
+```markdown
+## Known Issues
+- This agent cannot handle files larger than X
+- Requires MCP server Y to be running
+- Output format changes when ecomode is active
+```
+
+### 3. ARCH_DECISIONS — Why this agent exists this way
+
+```markdown
+## Design Decisions
+- Uses sonnet (not opus) because task complexity is moderate
+- Skills X and Y are included because they cover the primary workflow
+- Memory scope is project (not user) because knowledge is repo-specific
+```
+
+### 4. TEST_STRATEGY — How to verify the agent works
+
+```markdown
+## Verification
+- Run with sample input: `Agent(subagent_type: "this-agent", prompt: "test task")`
+- Expected: output matches format X
+- Edge case: empty input should return guidance, not error
+```
+
+## Frontmatter Quality Checklist
+
+| Field | Required | Quality Check |
+|-------|----------|---------------|
+| `name` | Yes | Matches filename (kebab-case) |
+| `description` | Yes | One line, specific (not generic "handles X") |
+| `model` | Yes | Justified by task complexity |
+| `tools` | Yes | Minimal set needed (no unnecessary tools) |
+| `skills` | No | Referenced skills must exist |
+| `domain` | No | Matches actual specialization |
+| `limitations` | No | Honest about what agent cannot do |
+
+## Anti-Patterns
+
+| Anti-Pattern | Problem | Fix |
+|-------------|---------|-----|
+| Kitchen-sink tools | `tools: [Read, Write, Edit, Bash, Agent, ...]` | Minimal tool set for the role |
+| Vague description | "Handles various tasks" | Specific: "Reviews Go code for idiomatic patterns" |
+| Copy-paste body | Duplicates guide content | Reference guide, don't copy |
+| Missing limitations | Sets unrealistic expectations | Declare what agent cannot do |
+| Orphaned skill refs | References non-existent skills | mgr-supplier audit catches this |
+| Excessive instructions | 500+ line body with detailed how-to | Move details to skills, keep agent body focused |
+
+## Verification Workflow
+
+```
+mgr-creator generates agent
+  → mgr-sauron verifies (R017)
+    → Frontmatter valid?
+    → Skills exist?
+    → Tools minimal?
+    → Description specific?
+  → Human reviews (optional but recommended for complex agents)
+  → Agent deployed
+```
+
+## Quality Metrics
+
+| Metric | Target |
+|--------|--------|
+| Body length | 50-200 lines (excluding frontmatter) |
+| Tool count | 3-8 (role-appropriate) |
+| Skill references | All resolvable |
+| Description length | 10-80 characters |
+| Limitations declared | At least 1 for complex agents |
+
+## Related
+
+- R006 — Agent design rules (frontmatter format, separation of concerns)
+- R017 — Sync verification (mgr-sauron validation)
+- `mgr-creator` — Agent creation workflow
+- `mgr-supplier` — Dependency audit

package/templates/guides/airflow/README.md

@@ -0,0 +1,47 @@
+# Apache Airflow Guide (3.1.8)
+
+Reference documentation for Apache Airflow 3.1.8 DAG development best practices.
+
+## Source
+
+Based on [Apache Airflow 3.1.8 official documentation](https://airflow.apache.org/docs/apache-airflow/3.1.8/) and [Astronomer best practices](https://docs.astronomer.io/).
+
+## Airflow 3.x Key Changes
+
+| Change | Details |
+|--------|---------|
+| SDK namespace | `from airflow.sdk import DAG, task, Asset` |
+| Task Execution (AIP-72) | Isolated subprocess execution via Execution API Server |
+| Internal API (AIP-44) | Components use API instead of direct DB access |
+| Asset (was Dataset) | Data-aware scheduling primitive renamed |
+| Context cleanup | `execution_date` → `dag_run.logical_date` |
+| New UI | React-based web interface |
+| TaskFlow API | `@task` is the default pattern for Python tasks |
+
+## Categories
+
+| Priority | Category | Impact |
+|----------|----------|--------|
+| 1 | DAG Authoring (airflow.sdk) | CRITICAL |
+| 2 | TaskFlow API & Dynamic Mapping | CRITICAL |
+| 3 | Testing (dag.test()) | HIGH |
+| 4 | Scheduling & Assets | HIGH |
+| 5 | Connections & Variables | MEDIUM |
+| 6 | Monitoring & SLA | MEDIUM |
+| 7 | Performance Optimization | LOW-MEDIUM |
+| 8 | 2.x → 3.x Migration | HIGH |
+
+## Usage
+
+This guide is referenced by:
+- **Agent**: de-airflow-expert
+- **Skill**: airflow-best-practices
+
+## External Resources
+
+- [Airflow 3.1.8 Official Docs](https://airflow.apache.org/docs/apache-airflow/3.1.8/)
+- [Airflow 3.1.8 Best Practices](https://airflow.apache.org/docs/apache-airflow/3.1.8/best-practices.html)
+- [Airflow Task SDK](https://airflow.apache.org/docs/apache-airflow/3.1.8/authoring-and-scheduling/index.html)
+- [Airflow TaskFlow API](https://airflow.apache.org/docs/apache-airflow/3.1.8/core-concepts/taskflow.html)
+- [Migration Guide 2.x → 3.x](https://airflow.apache.org/docs/apache-airflow/3.1.8/migration-guide.html)
+- [Astronomer Docs](https://docs.astronomer.io/)