oh-my-customcodex 0.1.0

package/templates/CLAUDE.md

@@ -0,0 +1,263 @@
+<!-- omcodex:start -->
+# 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 | 완료 검증 | **강제** - 작업 완료 선언 전 검증 필수 |
+| R021 | Enforcement Policy | **강제** - Advisory-first enforcement model |
+
+### SHOULD (강력 권장)
+| ID | 규칙 | 설명 |
+|----|------|------|
+| R003 | 상호작용 규칙 | 응답 원칙, 상태 형식 |
+| R004 | 오류 처리 | 오류 수준, 복구 전략 |
+| R011 | 메모리 통합 | omx-memory을 통한 세션 지속성 |
+| R012 | HUD 상태줄 | 실시간 상태 표시 |
+| R013 | Ecomode | 배치 작업 토큰 효율성 |
+| R019 | Ontology-RAG 라우팅 | 라우팅 스킬의 ontology-RAG enrichment |
+| R022 | Wiki 동기화 | 에이전트/스킬/룰/가이드 변경 시 위키 자동 동기화 |
+
+### MAY (선택)
+| ID | 규칙 | 설명 |
+|----|------|------|
+| R005 | 최적화 | 효율성, 토큰 최적화 |
+
+## 커맨드
+
+### 슬래시 커맨드 (스킬 기반)
+
+| 카테고리 | 대표 커맨드 | 설명 |
+|----------|------------|------|
+| 프로젝트 관리 | `/omcodex:analysis`, `/omcodex:create-agent`, `/omcodex:audit-agents` | 분석, 에이전트/스킬 생성, 감사 |
+| 아이디어 | `/idea` | 자연어 아이디어를 구조화된 이슈 스펙으로 변환 |
+| 개발 | `/dev-review`, `/dev-refactor`, `/sdd-dev`, `/structured-dev-cycle` | 코드 리뷰, 리팩토링, SDD |
+| 검증 | `/omcodex:sauron-watch`, `/deep-verify`, `/adversarial-review` | R017 검증, 릴리즈 품질, 보안 리뷰 |
+| 릴리즈 | `/pipeline auto-dev`, `/omcodex-release-notes`, `/release-plan` | 자동 개발, 릴리즈 노트 |
+| 리서치 | `/research`, `/scout`, `/deep-plan`, `/omcodex:agora` | 병렬 분석, URL 평가, 연구 계획 |
+| 메모리 | `/memory-save`, `/memory-recall` | 세션 메모리 관리 |
+| 시스템 | `/omcodex:lists`, `/omcodex:status`, `/omcodex:help` | 전체 목록, 상태, 도움말 |
+
+> 전체 커맨드 목록 (60+ 커맨드): `/omcodex:lists` 실행
+
+## 프로젝트 구조
+
+```
+project/
++-- AGENTS.md                    # 진입점
++-- .codex/
+|   +-- agents/                  # 서브에이전트 정의 (48 파일)
+|   +-- skills/                  # 스킬 (106 디렉토리)
+|   +-- rules/                   # 전역 규칙 (R000-R022)
+|   +-- hooks/                   # 훅 스크립트 (보안, 검증, HUD)
+|   +-- contexts/                # 컨텍스트 파일 (ecomode)
++-- 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의 핵심 철학입니다: **"전문가가 없으면? 만들고, 지식을 연결하고, 사용한다."**
+
+## 아키텍처 철학: 컴파일레이션 메타포
+
+oh-my-customcodex는 소프트웨어 컴파일과 동일한 구조를 따릅니다:
+
+| 컴파일 개념 | oh-my-customcodex 매핑 | 역할 |
+|------------|----------------------|------|
+| Source code | `.codex/skills/` | 재사용 가능한 지식과 워크플로우 정의 |
+| Build artifacts | `.codex/agents/` | 스킬을 조합한 실행 가능한 전문가 |
+| Compiler | `mgr-sauron` (R017) | 구조 검증 및 정합성 보장 |
+| Spec | `.codex/rules/` | 빌드 규칙과 제약 조건 |
+| Linker | Routing skills | 에이전트를 작업에 연결 |
+| Standard library | `guides/` | 공유 레퍼런스 문서 |
+
+이 메타포는 관심사 분리(R006)의 핵심입니다: 스킬(소스)을 에이전트(빌드 결과물)와 분리하여 독립적 진화를 가능하게 합니다.
+
+## 에이전트 요약
+
+| 타입 | 수량 | 에이전트 |
+|------|------|----------|
+| 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 |
+| **총계** | **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 | 라이브러리 문서 조회 |
+
+### 권장 플러그인
+
+| 플러그인 | 소스 | 용도 |
+|----------|------|------|
+| cc-token-saver | ww-w-ai/cc-token-saver | 토큰/비용 최적화 (Token Guardian, /continue, /usage-view) |
+
+### 권장 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 -->
+
+<!-- omcodex:end -->

package/templates/CLAUDE.md.en

@@ -0,0 +1,256 @@
+# 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 |
+| `/idea` | Turn a natural-language idea into structured issue specs |
+| `/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 (48 files)
+|   +-- skills/                  # Skills (106 directories)
+|   +-- rules/                   # Global rules (22 files)
+|   +-- hooks/                   # Hook scripts (security, validation, HUD)
+|   +-- contexts/                # Context files (4 files)
++-- guides/                      # Reference docs (38 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 | 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 |
+| Auxiliary | 1 | slack-cli-expert |
+| **Total** | **48** | |
+
+## 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 |
+
+### 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)
+omx memory doctor
+```
+
+<!-- omcodex:git-workflow -->