oh-my-customcodex 0.1.0

package/templates/.github/workflows/wiki-sync.yml

@@ -0,0 +1,132 @@
+name: Wiki Sync
+
+on:
+  push:
+    branches:
+      - develop
+    paths:
+      - '.claude/agents/**'
+      - '.claude/skills/**'
+      - '.claude/rules/**'
+      - 'guides/**'
+      - 'wiki/**'
+  pull_request:
+    branches:
+      - develop
+    paths:
+      - '.claude/agents/**'
+      - '.claude/skills/**'
+      - '.claude/rules/**'
+      - 'guides/**'
+      - 'wiki/**'
+
+concurrency:
+  group: wiki-sync-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  wiki-staleness-check:
+    name: Wiki Staleness Check
+    runs-on: macos-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+
+      - name: Check wiki directory exists
+        run: |
+          if [ ! -d "wiki" ]; then
+            echo "::error::wiki/ directory does not exist"
+            echo ""
+            echo "The wiki/ directory is required for this project."
+            echo "Fix: run '/omcustom:wiki' to generate the initial wiki"
+            exit 1
+          fi
+
+      - name: Check for missing wiki pages
+        run: |
+          #!/bin/bash
+          ERRORS=0
+          STALE=0
+          MISSING=0
+
+          # Check agents
+          for src in .claude/agents/*.md; do
+            name=$(basename "$src" .md)
+            wiki_page="wiki/agents/${name}.md"
+            if [ ! -f "$wiki_page" ]; then
+              echo "::error::Missing wiki page: $wiki_page (source: $src)"
+              MISSING=$((MISSING + 1))
+              ERRORS=$((ERRORS + 1))
+            fi
+          done
+
+          # Check skills
+          for src in $(find .claude/skills -name "SKILL.md"); do
+            name=$(basename $(dirname "$src"))
+            wiki_page="wiki/skills/${name}.md"
+            if [ ! -f "$wiki_page" ]; then
+              echo "::error::Missing wiki page: $wiki_page (source: $src)"
+              MISSING=$((MISSING + 1))
+              ERRORS=$((ERRORS + 1))
+            fi
+          done
+
+          # Check rules
+          for src in .claude/rules/*.md; do
+            # Extract rule ID (R000, R007, etc.) from content
+            rule_id=$(grep -oE 'ID\*\*: R[0-9]+' "$src" | grep -oE '[0-9]+' | head -1)
+            if [ -n "$rule_id" ]; then
+              wiki_page="wiki/rules/r$(printf '%03d' "$((10#$rule_id))").md"
+              if [ ! -f "$wiki_page" ]; then
+                echo "::error::Missing wiki page: $wiki_page (source: $src)"
+                MISSING=$((MISSING + 1))
+                ERRORS=$((ERRORS + 1))
+              fi
+            fi
+          done
+
+          # Check guides
+          for src in $(find guides -mindepth 1 -maxdepth 1 -type d); do
+            name=$(basename "$src")
+            wiki_page="wiki/guides/${name}.md"
+            if [ ! -f "$wiki_page" ]; then
+              echo "::error::Missing wiki page: $wiki_page (source: $src)"
+              MISSING=$((MISSING + 1))
+              ERRORS=$((ERRORS + 1))
+            fi
+          done
+
+          # Check index.md exists
+          if [ ! -f "wiki/index.yaml" ]; then
+            echo "::error::Missing wiki/index.yaml"
+            ERRORS=$((ERRORS + 1))
+          fi
+
+          # Summary
+          TOTAL_WIKI=$(find wiki -name "*.md" ! -name "index.md" ! -name "log.md" 2>/dev/null | wc -l | tr -d ' ')
+          echo "Wiki pages: $TOTAL_WIKI"
+          echo "Missing pages: $MISSING"
+
+          if [ "$ERRORS" -gt 0 ]; then
+            echo ""
+            echo "Fix: run '/omcustom:wiki' to regenerate wiki pages"
+            exit 1
+          fi
+
+          echo "Wiki sync check passed"
+
+      - name: Report results
+        if: success()
+        run: |
+          TOTAL_AGENTS=$(ls .claude/agents/*.md 2>/dev/null | wc -l | tr -d ' ')
+          TOTAL_SKILLS=$(find .claude/skills -name "SKILL.md" 2>/dev/null | wc -l | tr -d ' ')
+          TOTAL_RULES=$(ls .claude/rules/*.md 2>/dev/null | wc -l | tr -d ' ')
+          TOTAL_GUIDES=$(find guides -mindepth 1 -maxdepth 1 -type d 2>/dev/null | wc -l | tr -d ' ')
+          TOTAL_WIKI=$(find wiki -name "*.md" ! -name "index.md" ! -name "log.md" 2>/dev/null | wc -l | tr -d ' ')
+
+          echo "Source entities: agents=$TOTAL_AGENTS skills=$TOTAL_SKILLS rules=$TOTAL_RULES guides=$TOTAL_GUIDES"
+          echo "Wiki pages: $TOTAL_WIKI"
+          echo "All wiki pages present — sync OK"

package/templates/AGENTS.md.en

@@ -0,0 +1,255 @@
+# AI Agent System
+
+Powered by oh-my-customcodex, a child package of oh-my-customcode that layers this harness on top of GPT Codex + OMX.
+
+---
+## STOP AND READ BEFORE EVERY RESPONSE
+
+1. Response starts with agent identification? (R007) 2. Tool calls include identification? (R008) 3. Spawning 2+ agents? Check R018. → If NO to any, FIX IMMEDIATELY
+
+---
+
+## CRITICAL: Scope of Rules
+
+> **These rules apply ALWAYS, regardless of context:**
+
+| Context | Rules Apply? |
+|---------|-------------|
+| Working on this project | **YES** |
+| Working on external projects | **YES** |
+| After context compaction | **YES** |
+| Simple questions | **YES** |
+| ANY situation | **YES** |
+
+---
+
+## CRITICAL: Session Continuity
+
+> **These rules apply at ALL times, including after context compaction.**
+
+```
+When a session continues after "compact conversation":
+1. RE-READ this AGENTS.md IMMEDIATELY
+2. ALL enforcement rules remain ACTIVE
+3. Previous context summary does NOT override these rules
+4. First response MUST include agent identification
+
+NO EXCEPTIONS. NO EXCUSES.
+```
+
+---
+
+## CRITICAL: Enforcement Rules
+
+> **These rules are NON-NEGOTIABLE. Violation = immediate correction required.**
+
+| Rule | Core | On Violation |
+|------|------|-------------|
+| R007 Agent ID | Every response starts with `┌─ Agent:` header | Add header immediately |
+| R008 Tool ID | Every tool call prefixed with `[agent][model] → Tool:` | Add prefix immediately |
+| R009 Parallel | 2+ independent tasks → parallel agents (max 4) | Stop sequential, switch to parallel |
+| R010 Orchestrator | Orchestrator never modifies files → delegate to subagents | Stop direct modification, delegate |
+
+---
+
+## Global Rules (MUST comply)
+
+> See `.codex/rules/`
+
+### MUST (Never violate)
+| ID | Rule | Description |
+|----|------|-------------|
+| R000 | Language Policy | Korean I/O, English files, delegation model |
+| R001 | Safety Rules | Prohibited actions, required checks |
+| R002 | Permission Rules | Tool tiers, file access scope |
+| R006 | Agent Design | Agent structure, separation of concerns |
+| R007 | Agent Identification | **ENFORCED** - Display agent/skill in ALL responses |
+| R008 | Tool Identification | **ENFORCED** - Display agent when using ANY tool |
+| R009 | Parallel Execution | **ENFORCED** - Parallel execution, large task decomposition |
+| R010 | Orchestrator Coordination | **ENFORCED** - Orchestrator coordination, session continuity, direct action prohibition |
+| R015 | Intent Transparency | **ENFORCED** - Transparent agent routing |
+| R016 | Continuous Improvement | **ENFORCED** - Update rules when violations occur |
+| R017 | Sync Verification | **ENFORCED** - Verify sync before structural changes |
+| R018 | Agent Teams | **ENFORCED (Conditional)** - Mandatory for qualifying tasks when Agent Teams enabled |
+| R020 | Completion Verification | **ENFORCED** - Verification required before declaring task complete |
+
+### SHOULD (Strongly recommended)
+| ID | Rule | Description |
+|----|------|-------------|
+| R003 | Interaction Rules | Response principles, status format |
+| R004 | Error Handling | Error levels, recovery strategy |
+| R011 | Memory Integration | Session persistence with omx-memory |
+| R012 | HUD Statusline | Real-time status display |
+| R013 | Ecomode | Token efficiency for batch ops |
+| R019 | Ontology-RAG Routing | Ontology-RAG enrichment for routing skills |
+
+### MAY (Optional)
+| ID | Rule | Description |
+|----|------|-------------|
+| R005 | Optimization | Efficiency, token optimization |
+
+## Commands
+
+### Slash Commands (from Skills)
+
+| Command | Description |
+|---------|-------------|
+| `/omcodex:analysis` | Analyze project and auto-configure customizations |
+| `/omcodex:create-agent` | Create a new agent |
+| `/omcodex:update-docs` | Sync documentation with project structure |
+| `/omcodex:update-external` | Update agents from external sources |
+| `/omcodex:audit-agents` | Audit agent dependencies |
+| `/omcodex:fix-refs` | Fix broken references |
+| `/omcodex-takeover` | Extract canonical spec from existing agent/skill |
+| `/dev-review` | Review code for best practices |
+| `/dev-refactor` | Refactor code |
+| `/memory-save` | Save session context to omx-memory |
+| `/memory-recall` | Search and recall memories |
+| `/omcodex:monitoring-setup` | Enable/disable OTel console monitoring |
+| `/omcodex:npm-publish` | Publish package to npm registry |
+| `/omcodex:npm-version` | Manage semantic versions |
+| `/omcodex:npm-audit` | Audit dependencies |
+| `/omcodex-release-notes` | Generate release notes from git history |
+| `/codex-exec` | Execute Codex CLI prompts |
+| `/optimize-analyze` | Analyze bundle and performance |
+| `/optimize-bundle` | Optimize bundle size |
+| `/optimize-report` | Generate optimization report |
+| `/research` | 10-team parallel deep analysis and cross-verification |
+| `/deep-plan` | Research-validated planning (research → plan → verify) |
+| `/omcodex:sauron-watch` | Full R017 verification |
+| `/structured-dev-cycle` | 6-stage structured development cycle (Plan → Verify → Implement → Verify → Compound → Done) |
+| `/omcodex:lists` | Show all available commands |
+| `/omcodex:status` | Show system status |
+| `/omcodex:help` | Show help information |
+
+## Project Structure
+
+```
+project/
++-- AGENTS.md                    # Entry point
++-- .codex/
+|   +-- agents/                  # Subagent definitions (44 files)
+|   +-- skills/                  # Skills (74 directories)
+|   +-- rules/                   # Global rules (R000-R020)
+|   +-- hooks/                   # Hook scripts (security, validation, HUD)
+|   +-- contexts/                # Context files (ecomode)
++-- guides/                      # Reference docs (26 topics)
+```
+
+## Orchestration
+
+Orchestration is handled by routing skills in the main conversation:
+- **secretary-routing**: Routes management tasks to manager agents
+- **dev-lead-routing**: Routes development tasks to language/framework experts
+- **de-lead-routing**: Routes data engineering tasks to DE/pipeline experts
+- **qa-lead-routing**: Coordinates QA workflow
+
+The main conversation acts as the sole orchestrator. Subagents cannot spawn other subagents.
+
+### Dynamic Agent Creation
+
+When no existing agent matches a specialized task, the system automatically creates one:
+
+1. Routing skill detects no matching expert
+2. Orchestrator delegates to mgr-creator with detected context
+3. mgr-creator auto-discovers relevant skills and guides
+4. New agent is created and used immediately
+
+This is the core oh-my-customcodex philosophy: **"No expert? CREATE one, connect knowledge, and USE it."**
+
+## Agents Summary
+
+| Type | Count | Agents |
+|------|-------|--------|
+| 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 | 4 | fe-vercel-agent, fe-vuejs-agent, fe-svelte-agent, fe-flutter-agent |
+| SW Engineer/Tooling | 3 | tool-npm-expert, tool-optimizer, tool-bun-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 | 3 | db-supabase-expert, db-postgres-expert, db-redis-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 | 2 | sys-memory-keeper, sys-naggy |
+| **Total** | **44** | |
+
+## Agent Teams (MUST when enabled)
+
+When Codex CLI's Agent Teams feature is enabled (`OMCODEX_AGENT_TEAMS=1`), actively use it for qualifying tasks.
+
+| Feature | Subagents (Default) | Agent Teams |
+|---------|---------------------|-------------|
+| Communication | Results to caller only | Peer-to-peer mailbox |
+| Coordination | Orchestrator manages | Shared task list |
+| Best for | Focused tasks | Research, review, debugging |
+| Token cost | Lower | Higher |
+
+**When enabled, Agent Teams is MANDATORY for qualifying collaborative tasks (R018 MUST).**
+See R018 (MUST-agent-teams.md) for the decision matrix.
+Hybrid patterns (Claude + Codex, Dynamic Creation + Teams) are supported.
+Task tool + routing skills remain the fallback for simple/cost-sensitive tasks.
+
+## Quick Reference
+
+```bash
+# Project analysis
+/omcodex:analysis
+
+# Show all commands
+/omcodex:lists
+
+# Agent management
+/omcodex:create-agent my-agent
+/omcodex:update-docs
+/omcodex:audit-agents
+
+# Code review
+/dev-review src/main.go
+
+# Memory management
+/memory-save
+/memory-recall authentication
+
+# Verification
+/omcodex:sauron-watch
+```
+
+## External Dependencies
+
+### Required Plugins
+
+Install via `/plugin install <name>`:
+
+| Plugin | Source | Purpose |
+|--------|--------|---------|
+| superpowers | claude-plugins-official | TDD, debugging, collaboration patterns |
+| openai-docs | superpowers-marketplace | OpenAI and Codex development documentation |
+| elements-of-style | superpowers-marketplace | Writing clarity guidelines |
+| obsidian-skills | - | Obsidian markdown support |
+| context7 | claude-plugins-official | Library documentation lookup |
+
+### Recommended MCP Servers
+
+| Server | Purpose |
+|--------|---------|
+| omx-memory | Session memory persistence (Chroma-based) |
+
+### Setup Commands
+
+```bash
+# Add marketplace
+/plugin marketplace add obra/superpowers-marketplace
+
+# Install plugins
+/plugin install superpowers
+/plugin install openai-docs
+/plugin install elements-of-style
+
+# MCP setup (omx-memory)
+npm install -g omx-memory
+omx-memory setup
+```
+
+<!-- omcodex:git-workflow -->

package/templates/AGENTS.md.ko

@@ -0,0 +1,255 @@
+# 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` | 프로젝트 분석 및 자동 커스터마이징 |
+| `/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/                  # 서브에이전트 정의 (44 파일)
+|   +-- skills/                  # 스킬 (74 디렉토리)
+|   +-- rules/                   # 전역 규칙 (R000-R020)
+|   +-- hooks/                   # 훅 스크립트 (보안, 검증, HUD)
+|   +-- contexts/                # 컨텍스트 파일 (ecomode)
++-- guides/                      # 레퍼런스 문서 (26 토픽)
+```
+
+## 오케스트레이션
+
+오케스트레이션은 메인 대화의 라우팅 스킬로 처리됩니다:
+- **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 | 4 | fe-vercel-agent, fe-vuejs-agent, fe-svelte-agent, fe-flutter-agent |
+| SW Engineer/Tooling | 3 | tool-npm-expert, tool-optimizer, tool-bun-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 | 3 | db-supabase-expert, db-postgres-expert, db-redis-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 | 2 | sys-memory-keeper, sys-naggy |
+| **총계** | **44** | |
+
+## 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 | 세션 메모리 영속성 (Chroma 기반) |
+
+### 설치 명령어
+
+```bash
+# 마켓플레이스 추가
+/plugin marketplace add obra/superpowers-marketplace
+
+# 플러그인 설치
+/plugin install superpowers
+/plugin install openai-docs
+/plugin install elements-of-style
+
+# MCP 설정 (omx-memory)
+npm install -g omx-memory
+omx-memory setup
+```
+
+<!-- omcodex:git-workflow -->