Codex System — Deep Reasoning Partner

Codex CLI (gpt-5.2-codex) is your highly capable supporter for deep reasoning tasks.

상세규칙: .claude/rules/codex-delegation.md

Context Management (CRITICAL)

서브에이전트 경유 권장이다. 메인 오케스트레이터의 컨텍스트를 절약하기 위해.

When to Consult (MUST)

When NOT to Consult

• Simple file edits, typo fixes
• Following explicit user instructions
• git commit, running tests, linting
• Tasks with obvious single solutions

How to Consult

Recommended: Subagent Pattern

Use Task tool with subagent_type='general-purpose' to preserve main context.

Task tool parameters:
- subagent_type: "general-purpose"
- run_in_background: true (optional, for parallel work)
- prompt: |
    Consult Codex about: {topic}

    codex exec --model gpt-5.2-codex --sandbox read-only --full-auto "
    {question for Codex}
    " 2>/dev/null

    Return CONCISE summary (key recommendation + rationale).

Direct Call (Short Questions Only)

For quick questions expecting 1-2 sentence answers:

codex exec --model gpt-5.2-codex --sandbox read-only --full-auto "Brief question" 2>/dev/null

Workflow (Subagent)

1. Spawn subagent with Codex consultation prompt
2. Continue your work → Subagent runs in parallel
3. Receive summary → Subagent returns concise insights

Sandbox Modes

Language Protocol

1. Ask Codex in English
2. Receive response in English
3. Execute based on advice (or let Codex execute)
4. Report to user in Korean

Task Templates

Design Review

codex exec --model gpt-5.2-codex --sandbox read-only --full-auto "
Review this design approach for: {feature}

Context:
{relevant code or architecture}

Evaluate:
1. Is this approach sound?
2. Alternative approaches?
3. Potential issues?
4. Recommendations?
" 2>/dev/null

Debug Analysis

codex exec --model gpt-5.2-codex --sandbox read-only --full-auto "
Debug this issue:

Error: {error message}
Code: {relevant code}
Context: {what was happening}

Analyze root cause and suggest fixes.
" 2>/dev/null

Code Review

See: references/code-review-task.md

Refactoring

See: references/refactoring-task.md

Integration with Gemini

Why Codex?

• Deep reasoning: Complex analysis and problem-solving
• Code expertise: Implementation strategies and patterns
• Consistency: Same project context via context-loader skill
• Parallel work: Background execution keeps you productive