diff --git a/.claude/workflows/codex-unified.md b/.claude/workflows/codex-unified.md index db0a69ca..189e7875 100644 --- a/.claude/workflows/codex-unified.md +++ b/.claude/workflows/codex-unified.md @@ -4,9 +4,10 @@ description: Comprehensive Codex CLI guidelines - core rules, syntax, patterns, type: technical-guideline --- -### 🚀 Command Overview: Bash(codex *) +### 🚀 Command Overview: Bash(codex *) - **Purpose**: An AI-powered CLI tool for automated codebase analysis, intelligent code generation, and autonomous development workflows. +- **⚠️ CRITICAL**: **NO wrapper script exists** - always use direct `codex` command, never `~/.claude/scripts/codex` - **Key Characteristic**: **No `--all-files` flag** - requires explicit `@` pattern references for file inclusion. - **Directory Analysis Rule**: When user intends to analyze specific directory (cd XXX), use: `bash(codex --cd XXX --full-auto exec "prompt")` or `bash(cd XXX && codex --full-auto exec "@{**/*} prompt")` - **Default Mode**: `--full-auto exec` autonomous development mode (RECOMMENDED for all tasks). @@ -42,8 +43,10 @@ type: technical-guideline - **Basic Structure** (Priority Order): ```bash bash(codex --full-auto exec "autonomous development task") # DEFAULT & RECOMMENDED - bash(codex --full-auto exec "prompt with @{patterns}") # For specific control needs + bash(codex --full-auto exec "prompt with @{patterns}") # For specific control needs ``` + + **⚠️ NEVER use**: `~/.claude/scripts/codex` - this wrapper script does not exist! - **Key Commands** (In Order of Preference): - `bash(codex --full-auto exec "...")` ⭐ **PRIMARY MODE** - Full autonomous development - `bash(codex --full-auto exec "...")` - Controlled execution when you need specific patterns diff --git a/.claude/workflows/intelligent-tools.md b/.claude/workflows/intelligent-tools.md index c6583ae3..fae63b61 100644 --- a/.claude/workflows/intelligent-tools.md +++ b/.claude/workflows/intelligent-tools.md @@ -16,6 +16,7 @@ This document provides strategic guidance for selecting the appropriate analysis ## Tool Characteristics Comparison ### Gemini +- **Command Syntax**: `bash(~/.claude/scripts/gemini-wrapper -p "prompt")` (HAS wrapper script) - **Strengths**: - Large context window for analyzing many files simultaneously - Excellent pattern recognition across modules @@ -27,6 +28,7 @@ This document provides strategic guidance for selecting the appropriate analysis - Refactoring with broad dependencies ### Codex +- **Command Syntax**: `bash(codex --full-auto exec "prompt")` (NO wrapper script - direct command only) - **Strengths**: - Superior mathematical and algorithmic reasoning - Deeper technical knowledge base @@ -82,6 +84,20 @@ Task(subagent_type="general-purpose", Commands should reference this strategy guide for tool selection decisions. Specific tool usage syntax and examples are documented in their respective unified guides. +## ⚠️ CRITICAL Command Syntax Differences + +**Gemini** (HAS intelligent wrapper): +```bash +bash(~/.claude/scripts/gemini-wrapper -p "analyze patterns") +``` + +**Codex** (NO wrapper - direct command only): +```bash +bash(codex --full-auto exec "implement feature") +``` + +**❌ NEVER use**: `~/.claude/scripts/codex` - this does not exist! + **See also**: - Gemini detailed usage: @~/.claude/workflows/gemini-unified.md - Codex detailed usage: @~/.claude/workflows/codex-unified.md \ No newline at end of file diff --git a/CLAUDE.md b/CLAUDE.md index b02badbb..5143c618 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -5,8 +5,6 @@ This document defines project-specific coding standards and development principles. ### CLI Tool Context Protocols For all CLI tool usage, command syntax, and integration guidelines: -- **Gemini (Analysis)**: @~/.claude/workflows/gemini-unified.md -- **Codex (Development)**: @~/.claude/workflows/codex-unified.md - **Tool Selection Strategy**: @~/.claude/workflows/intelligent-tools.md ### Intelligent Context Acquisition