oh-my-customcodex 0.5.8 → 0.5.9

package/templates/.claude/skills/roundtable-debate/SKILL.md

@@ -12,7 +12,7 @@ version: 1.0.0
 
 ## Purpose
 
-Run a bounded debate when convergence would hide useful disagreement. Unlike `agora`, which drives toward consensus, this workflow preserves minority positions and requires explicit justification before dismissing them.
+Run a bounded debate when convergence would hide useful disagreement. Use this workflow when debate should preserve minority positions and require explicit justification before dismissing them.
 
 ## When To Use
 
@@ -54,11 +54,10 @@ Hard cap: two debate rounds. If the decision still depends on missing facts, sto
 {adopt | defer | reject | gather-more-evidence}
 ```
 
-## Relationship To Agora
+## Relationship To Other Review Workflows
 
 | Workflow | Goal | Best For |
 |----------|------|----------|
-| `agora` | adversarial consensus | release gates, spec approval |
 | `roundtable-debate` | dissent preservation | ambiguous strategy, architectural tradeoffs |
 
-Use `agora --anti-groupthink` when you need consensus plus explicit dissent handling.
+Use `roundtable-debate` when current guidance needs adversarial review plus explicit dissent handling.

package/templates/.claude/skills/structured-dev-cycle/SKILL.md

@@ -93,15 +93,12 @@ A PreToolUse hook in `.codex/hooks/hooks.json` checks this marker and blocks Wri
 └── Output: Implementation complete
 ```
 
-**Codex-Exec Hybrid Option**: When entering Stage 3:
-1. Check `/tmp/.codex-env-status-*` for codex CLI availability
-2. If available AND task involves new file creation → automatically delegate scaffolding to `/codex-exec`:
-   - Display: `[Codex Hybrid] Delegating scaffolding to codex-exec...`
-   - codex-exec generates initial code (strength: fast generation)
-   - Claude expert reviews and refines codex output (strength: reasoning, quality)
-3. If unavailable → display `[Codex] Unavailable — proceeding with Claude experts directly` and proceed with standard implementation via Claude experts
-
-Suitable for codex hybrid: new files, boilerplate, test stubs, scaffolding
+**Optional Codex Plugin Interop**: When entering Stage 3:
+1. Use domain expert agents as the default implementation path.
+2. If the native Claude Code plugin `openai/codex-plugin-cc` is explicitly installed and requested, it may provide Codex interop for new-file scaffolding before expert review.
+3. Otherwise display `[Codex Plugin] Not requested — proceeding with expert agents directly` and proceed with standard implementation.
+
+Suitable for optional plugin interop: new files, boilerplate, test stubs, scaffolding
 Not suitable: modifying existing code, architecture-dependent changes
 
 **Exit criteria**: All planned files created/modified, tests written.
@@ -157,7 +154,7 @@ The stage marker file (`/tmp/.codex-dev-stage`) is read by a PreToolUse hook tha
 For complex tasks, Agent Teams is **preferred** when available (R018):
 - Plan: architect agent
 - Verify: reviewer agent(s) — multi-model-verification via Agent Teams
-- Implement: domain expert agent (+ codex-exec hybrid if available)
+- Implement: domain expert agent (+ optional `openai/codex-plugin-cc` interop only when explicitly installed/requested)
 - Compound: QA agent
 
 When Agent Teams is enabled AND task involves 3+ agents or review→fix cycles, using Agent Teams is MANDATORY per R018.

package/templates/AGENTS.md.en

@@ -110,7 +110,6 @@ NO EXCEPTIONS. NO EXCUSES.
 | `/omcustomcodex:npm-version` | Manage semantic versions |
 | `/omcustomcodex:npm-audit` | Audit dependencies |
 | `/omcustomcodex-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 |
@@ -134,7 +133,7 @@ project/
 |   +-- hooks/                   # Hook scripts (security, validation, HUD)
 |   +-- contexts/                # Context files (ecomode)
 +-- .agents/
-|   +-- skills/                  # Installed skills (123 directories)
+|   +-- skills/                  # Installed skills (120 directories)
 +-- guides/                      # Reference docs (51 topics)
 ```
 

package/templates/AGENTS.md.ko

@@ -110,7 +110,6 @@ oh-my-customcodex로 구동됩니다.
 | `/omcustomcodex:npm-version` | 시맨틱 버전 관리 |
 | `/omcustomcodex:npm-audit` | 의존성 감사 |
 | `/omcustomcodex-release-notes` | 릴리즈 노트 생성 (git 히스토리 기반) |
-| `/codex-exec` | Codex CLI 프롬프트 실행 |
 | `/optimize-analyze` | 번들 및 성능 분석 |
 | `/optimize-bundle` | 번들 크기 최적화 |
 | `/optimize-report` | 최적화 리포트 생성 |
@@ -134,7 +133,7 @@ project/
 |   +-- hooks/                   # 훅 스크립트 (보안, 검증, HUD)
 |   +-- contexts/                # 컨텍스트 파일 (ecomode)
 +-- .agents/
-|   +-- skills/                  # 설치된 스킬 (123 디렉토리)
+|   +-- skills/                  # 설치된 스킬 (120 디렉토리)
 +-- guides/                      # 레퍼런스 문서 (51 토픽)
 ```
 

package/templates/CLAUDE.md

@@ -102,7 +102,7 @@ oh-my-customcodex로 구동됩니다.
 | 개발 | `/omcustomcodex:goal`, `/dev-review`, `/dev-refactor`, `/sdd-dev`, `/structured-dev-cycle` | 목표 실행, 코드 리뷰, 리팩토링, SDD |
 | 검증 | `/omcustomcodex:sauron-watch`, `/deep-verify`, `/adversarial-review` | R017 검증, 릴리즈 품질, 보안 리뷰 |
 | 릴리즈 | `/pipeline auto-dev`, `/omcustomcodex-release-notes`, `/release-plan` | 자동 개발, 릴리즈 노트 |
-| 리서치 | `/research`, `/scout`, `/deep-plan`, `/omcustomcodex:agora` | 병렬 분석, URL 평가, 연구 계획 |
+| 리서치 | `/research`, `/scout`, `/deep-plan`, `/roundtable-debate` | 병렬 분석, URL 평가, 토론형 검증 |
 | 메모리 | `/memory-save`, `/memory-recall` | 세션 메모리 관리 |
 | 시스템 | `/token-efficiency-audit`, `/pre-generation-arch-check`, `/omcustomcodex:lists`, `/omcustomcodex:status`, `/omcustomcodex:help` | 토큰 효율/아키텍처 감사, 전체 목록, 상태, 도움말 |
 
@@ -119,7 +119,7 @@ project/
 |   +-- hooks/                   # 훅 스크립트 (보안, 검증, HUD)
 |   +-- contexts/                # 컨텍스트 파일 (ecomode)
 +-- .agents/
-|   +-- skills/                  # 스킬 (123 디렉토리)
+|   +-- skills/                  # 스킬 (120 디렉토리)
 +-- guides/                      # 레퍼런스 문서 (51 토픽)
 ```
 

package/templates/CLAUDE.md.en

@@ -112,7 +112,6 @@ NO EXCEPTIONS. NO EXCUSES.
 | `/omcustomcodex:npm-version` | Manage semantic versions |
 | `/omcustomcodex:npm-audit` | Audit dependencies |
 | `/omcustomcodex-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 |
@@ -133,7 +132,7 @@ project/
 +-- AGENTS.md                    # Entry point
 +-- .codex/
 |   +-- agents/                  # Subagent definitions (50 files)
-|   +-- skills/                  # Skills (123 directories)
+|   +-- skills/                  # Skills (120 directories)
 |   +-- rules/                   # Global rules (22 files)
 |   +-- hooks/                   # Hook scripts (security, validation, HUD)
 |   +-- contexts/                # Context files (4 files)

package/templates/CLAUDE.md.ko

@@ -112,7 +112,6 @@ oh-my-customcodex로 구동됩니다.
 | `/omcustomcodex:npm-version` | 시맨틱 버전 관리 |
 | `/omcustomcodex:npm-audit` | 의존성 감사 |
 | `/omcustomcodex-release-notes` | 릴리즈 노트 생성 (git 히스토리 기반) |
-| `/codex-exec` | Codex CLI 프롬프트 실행 |
 | `/optimize-analyze` | 번들 및 성능 분석 |
 | `/optimize-bundle` | 번들 크기 최적화 |
 | `/optimize-report` | 최적화 리포트 생성 |
@@ -133,7 +132,7 @@ project/
 +-- AGENTS.md                    # 진입점
 +-- .codex/
 |   +-- agents/                  # 서브에이전트 정의 (50 파일)
-|   +-- skills/                  # 스킬 (123 디렉토리)
+|   +-- skills/                  # 스킬 (120 디렉토리)
 |   +-- rules/                   # 전역 규칙 (22 파일)
 |   +-- hooks/                   # 훅 스크립트 (보안, 검증, HUD)
 |   +-- contexts/                # 컨텍스트 파일 (4 파일)

package/templates/README.md

@@ -46,7 +46,7 @@ templates/
 +-- workflows/                        # project-level pipeline definitions
 +-- .claude/
 |   +-- agents/                       # agent definitions (50 files)
-|   +-- skills/                       # skill modules (123 SKILL.md files)
+|   +-- skills/                       # skill modules (120 SKILL.md files)
 |   +-- rules/                        # global rules (22 files)
 |   +-- hooks/                        # hook registry and scripts (40 scripts)
 |   +-- contexts/                     # context files
@@ -65,7 +65,7 @@ The counts below should stay aligned with `templates/manifest.json`, README comp
 
 Flat agent definition files. During Codex installation these land under `.codex/agents/`.
 
-### Skills (123)
+### Skills (120)
 
 `templates/.claude/skills/*/SKILL.md`
 

package/templates/guides/multi-agent-debate-patterns/README.md

@@ -4,7 +4,7 @@
 
 | Pattern | Goal | Use When |
 |---------|------|----------|
-| `agora` | Reach adversarial consensus | Release gates, design approval, high-risk specs |
+| `roundtable-debate` | Preserve dissent while reaching a bounded decision | Release gates, design approval, high-risk specs with minority risks |
 | `roundtable-debate` | Preserve dissent | Strategy choices, tradeoffs, ambiguous product or architecture decisions |
 
 ## Failure Modes

package/templates/guides/multi-provider-exec/README.md

@@ -1,83 +1,13 @@
-# Multi-Provider Exec
+# External Interop Guidance
 
-## Overview
+The packaged multi-provider exec skills have been retired. For Codex interoperability, use the official Claude Code plugin `openai/codex-plugin-cc` only when it is explicitly installed and requested.
 
-Unified reference for executing prompts through external LLM providers via exec skills. Complements the [Multi-Model Routing](../multi-model-routing/README.md) guide (Claude model selection) with cross-provider execution capabilities.
+## Current Paths
 
-Inspired by OpenHarness's provider profile switching pattern, adapted for oh-my-customcodex's skill-based architecture.
+| Need | Preferred path | Notes |
+|------|----------------|-------|
+| Codex interop | `openai/codex-plugin-cc` | Official plugin path; opt-in only. |
+| Token-optimized local command output | `rtk-exec` | Existing RTK proxy remains supported. |
+| Research or independent review | `researcher`, expert agents, or `roundtable-debate` | Prefer in-repo agent workflows unless plugin interop is requested. |
 
-## Provider Matrix
-
-| Provider | Skill | CLI Dependency | Model | Strengths |
-|----------|-------|---------------|-------|-----------|
-| OpenAI (Codex) | `codex-exec` | `codex` CLI | GPT-5.4 | Code generation, broad knowledge |
-| Google (Gemini) | `gemini-exec` | `gemini` CLI | Gemini 2.5 Pro | Long context, multimodal |
-| RTK (proxy) | `rtk-exec` | `rtk` CLI | Configurable | Token-optimized output, cost reduction |
-
-## Availability Detection
-
-The `session-env-check.sh` hook (SessionStart) auto-detects available providers:
-
-```
-[SessionStart] Checking external CLI availability...
-  codex: ✓ available
-  gemini: ✗ not found
-  rtk: ✓ available
-```
-
-Providers are opt-in — missing CLIs are silently skipped.
-
-## Usage Patterns
-
-### Direct Invocation
-
-```
-/codex-exec "Review this function for security issues"
-/gemini-exec "Analyze this architecture diagram"
-/rtk-exec "List files matching pattern X"
-```
-
-### Provider Selection Guide
-
-| Task | Recommended Provider | Rationale |
-|------|---------------------|-----------|
-| Second opinion on code review | codex-exec | Independent model reduces confirmation bias |
-| Long document analysis | gemini-exec | 1M+ context window |
-| Token-heavy batch operations | rtk-exec | Compressed output reduces context cost |
-| Security audit cross-check | codex-exec | Different training data catches different patterns |
-| Multi-model verification | All three | `/multi-model-verification` skill orchestrates this |
-
-### Integration with Existing Skills
-
-| Skill | Uses Provider | How |
-|-------|--------------|-----|
-| `multi-model-verification` | codex-exec + gemini-exec | Parallel verification with severity classification |
-| `reasoning-sandwich` | Any exec skill | Pre/post reasoning with different models |
-| `model-escalation` | Claude models only | Internal escalation (haiku→sonnet→opus), not cross-provider |
-
-## Relationship to Multi-Model Routing
-
-| Aspect | Multi-Model Routing | Multi-Provider Exec |
-|--------|--------------------|--------------------|
-| Scope | Claude model selection | Cross-provider execution |
-| Models | haiku / sonnet / opus | GPT-5.4 / Gemini 2.5 / RTK proxy |
-| Mechanism | `model` frontmatter field | Exec skill invocation |
-| Use case | Cost/quality optimization within Claude | Independent verification, specialized tasks |
-| Guide | `guides/multi-model-routing/` | `guides/multi-provider-exec/` |
-
-## Configuration
-
-No global configuration required. Each exec skill reads its own CLI configuration:
-
-| Skill | Config Source |
-|-------|-------------|
-| codex-exec | `~/.codex/config` or CODEX_API_KEY env |
-| gemini-exec | `~/.gemini/config` or GEMINI_API_KEY env |
-| rtk-exec | RTK proxy running on localhost |
-
-## Limitations
-
-- Provider availability depends on user's CLI installations
-- Cross-provider results are advisory — Claude remains the primary execution engine
-- No automatic fallback between providers (by design — explicit selection preferred)
-- Rate limits and costs are provider-specific and not tracked by oh-my-customcodex
+Do not auto-delegate to retired provider wrapper skills. Keep expert agents responsible for reviewing any plugin-assisted output.

package/templates/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.5.8",
+  "version": "0.5.9",
   "requiresCC": ">=2.1.121",
   "claudeCode": {
     "minimumVersion": "2.1.121",
@@ -23,7 +23,7 @@
       "name": "skills",
       "path": ".agents/skills",
       "description": "Reusable skill modules (project-scoped repo skills)",
-      "files": 123
+      "files": 120
     },
     {
       "name": "guides",

package/templates/.claude/skills/agora/SKILL.md

@@ -1,209 +0,0 @@
----
-name: omcustomcodex:agora
-description: "Multi-LLM adversarial consensus loop — 3+ LLMs compete to find flaws in designs/specs until unanimous agreement is reached"
-user-invocable: true
-argument-hint: "<document-path> [--rounds N] [--severity-threshold HIGH]"
-effort: max
-scope: core
-version: 1.0.0
-source:
-  type: external
-  origin: github
-  url: https://github.com/baekenough/baekenough-skills
-  version: 1.0.0
----
-
-# Agora: Multi-LLM Adversarial Consensus
-
-3개 이상의 LLM(Claude, Codex/GPT, Gemini)이 경쟁적으로 설계/문서의 결함을 찾고, 만장일치 합의에 도달할 때까지 반복하는 적대적 교차 검증 스킬.
-
-## Prerequisites
-
-- `codex-exec` skill (Codex/GPT 호출)
-- `gemini-exec` skill (Gemini 호출)
-- Agent Teams enabled (`OMCODEX_AGENT_TEAMS=1`) or Agent tool available
-
-## Sensitive-Path Delegation
-
-Sensitive-path compatibility note: if this skill delegates work that touches `.claude/**`, `.claude/outputs/**`, `templates/.claude/**`, or read-only measurements of those paths, keep `.codex/**` edits on the normal Codex path. On Claude Code v2.1.121+ with `bypassPermissions`, direct writes to `.claude/skills/`, `.claude/agents/`, and `.claude/commands/` are allowed; on v2.1.126+ that extends to broader protected paths. Only use `/tmp/{skill}-{timestamp}.md` as a legacy fallback when the target runtime is older or still prompts.
-
-## Usage
-
-```
-/omcustomcodex:agora docs/design.md                           # Default: 3 LLMs, unlimited rounds
-/omcustomcodex:agora docs/design.md --rounds 10               # Max 10 rounds
-/omcustomcodex:agora docs/design.md --severity-threshold HIGH # Exit when no HIGH+ findings
-/omcustomcodex:agora docs/design.md --models claude,codex     # 2 LLMs only
-```
-
-## Workflow
-
-### Phase 1: Setup
-1. Read the target document
-2. Create Agent Team: `TeamCreate("agora-review")`
-3. Create review tasks per focus area
-
-### Phase 2: Spawn Reviewers (parallel)
-Spawn 3 reviewers as Agent Team members:
-
-```
-
-### Anti-Groupthink Mode
-
-Use `--anti-groupthink` when consensus itself is a risk:
-
-1. Reviewers submit independent findings before seeing peer output.
-2. One reviewer is assigned as devil's advocate.
-3. Minority findings are preserved unless the synthesis explicitly rejects them with evidence.
-4. Debate is capped at two challenge rounds before the lead either decides or requests more facts.
-
-For decisions where dissent preservation is the main goal, use `roundtable-debate` directly instead of `agora`.
-Agent(name: "claude-critic", model: opus, effort: max)
-  → 20-point deep adversarial review
-  
-Agent(name: "codex-critic", model: opus)
-  → Invoke Skill(codex-exec) for GPT perspective + independent Claude analysis
-  
-Agent(name: "gemini-critic", model: opus)  
-  → Invoke Skill(gemini-exec) for Gemini perspective + independent Claude analysis
-```
-
-### Phase 3: Independent Review
-Each reviewer performs adversarial review with this template:
-
-```
-For EACH review point:
-### Round N: [Topic]
-**Severity**: CRITICAL / HIGH / MEDIUM / LOW
-**Flaw**: [Specific, concrete problem description]
-**Evidence**: [Why this is real, not theoretical]
-**Impact**: [What happens if not addressed]
-**Counter-argument**: [Best case FOR the current design]
-**Verdict**: KEEP / MODIFY / REJECT
-```
-
-Review areas (adapt to document type):
-- Architecture fundamentals
-- Component/service design
-- Data architecture
-- Security & resilience
-- Feasibility & deployment
-- Testing strategy
-- Operational complexity
-
-### Phase 4: Cross-Review (Peer-to-Peer)
-Each reviewer sends findings to the other two via `SendMessage`.
-
-Counter-review template:
-1. Which findings do you **AGREE** with? (and why)
-2. Which findings do you **DISAGREE** with? (evidence-based rebuttal)
-3. What did they **MISS** that you caught?
-4. What did they catch that you **MISSED**?
-5. **SEVERITY** adjustments — upgrade or downgrade with justification
-
-### Phase 5: Synthesis
-Team lead aggregates all findings:
-
-```
-UNANIMOUS CRITICAL: [findings all 3 agreed on]
-STRONG AGREEMENT:   [findings 2/3 agreed on]
-SPLIT DECISIONS:    [findings with disagreement + resolution]
-```
-
-Determine verdict:
-- **BUILD**: No CRITICAL, no unresolved HIGH
-- **BUILD WITH CHANGES**: No CRITICAL, HIGH findings have accepted mitigations
-- **REDESIGN**: Any unresolved CRITICAL findings
-- **ABANDON**: Fundamental concept is flawed
-
-### Phase 6: Loop (if REDESIGN)
-1. Team lead produces/delegates redesign addressing ALL critical findings
-2. New version sent to ALL reviewers: `SendMessage(to: "*")`
-3. Reviewers re-review → GOTO Phase 4
-4. Repeat until EXIT criteria met
-
-### Phase 7: Exit (consensus reached)
-When ALL reviewers agree BUILD or BUILD WITH CHANGES:
-1. Produce final consensus report
-2. Write to `.codex/outputs/sessions/{date}/agora-{topic}-{time}.md`
-3. Shut down team: `SendMessage(to: "*", message: {type: "shutdown_request"})`
-
-## Reviewer Principles
-
-1. **NEUTRAL** — no reviewer has home team advantage
-2. **COMPETITIVE** — find flaws others missed
-3. **CRITICAL** — "fewer than 5 CRITICAL flaws = not looking hard enough"
-4. **EVIDENCE-BASED** — every finding cites specific evidence
-5. **CONSTRUCTIVE** — every flaw includes recommended fix
-6. **CONVERGENT** — goal is consensus, not endless disagreement
-
-## Consensus Criteria
-
-| Condition | Required |
-|-----------|----------|
-| CRITICAL findings resolved | ALL |
-| HIGH findings resolved or accepted | ALL |
-| All reviewers rate BUILD or BUILD WITH CHANGES | YES |
-| Cross-review disagreements resolved | ALL |
-
-## Output Format
-
-```markdown
-# Agora Consensus Report
-
-## Document: [path]
-## Rounds: [N]
-## Reviewers: [list with LLM models used]
-
-## Verdict: [BUILD / BUILD WITH CHANGES / REDESIGN]
-
-## Unanimous Findings
-| # | Finding | Severity | All 3 Agree |
-|---|---------|----------|-------------|
-
-## Required Changes Before Build
-1. [change with source reviewer]
-2. ...
-
-## Accepted Risks
-- [finding accepted with justification]
-
-## Unique Contributions Per Reviewer
-| Reviewer | Findings Others Missed |
-|----------|----------------------|
-
-## Process Metrics
-- Rounds: N
-- Total findings: N
-- Cross-adopted: N
-- Severity upgrades: N
-- Severity downgrades: N
-- Disagreements raised: N
-- Disagreements resolved: N/N
-```
-
-## Configuration
-
-```yaml
-# Default settings
-agora:
-  max_rounds: unlimited       # Set --rounds to limit
-  severity_threshold: HIGH    # EXIT when no findings >= threshold
-  models:
-    - claude (opus, max effort)
-    - codex (via codex-exec skill)
-    - gemini (via gemini-exec skill)
-  review_points: 20           # Per reviewer
-  cross_review: true          # Peer-to-peer sharing
-  auto_redesign: true         # Auto-produce redesign on REDESIGN verdict
-```
-
-## Anti-Patterns
-
-| Anti-Pattern | Why Wrong | Correct |
-|-------------|-----------|---------|
-| Single LLM review | Misses blind spots | 3+ LLMs find complementary flaws |
-| No cross-review | Reviewers don't challenge each other | Peer-to-peer sharing surfaces disagreements |
-| Accepting first BUILD | May miss edge cases | Loop until ALL agree |
-| Ignoring split decisions | Unresolved disagreements fester | Resolve every split with evidence |
-| Push for consensus too fast | Premature agreement | Let reviewers challenge freely |