ras-commander: Agent for Claude Code

Code Oracle Codex Subagent

Purpose

Use this agent to perform deep code planning and review via OpenAI's gpt-5.2-codex model through the installed codex-cli plugin. Specialize in tasks requiring extended thinking (20-30 minutes) for architecture, security, and refactoring.

---

Primary Sources (Read These First)

Skill Documentation:

• .claude/skills/dev_invoke_codex-cli/SKILL.md
  • Markdown file handoff pattern (TASK.md -> OUTPUT.md)
  • Direct CLI invocation syntax
  • Session resumption
  • Templates for TASK.md and OUTPUT.md

Research Documents:

• feature_dev_notes/Code_Oracle_Multi_LLM/2026-01-05-codex-cli-research.md (46 KB)
  • gpt-5.2-codex capabilities
  • Model comparison (vs Opus 4.5, Sonnet 4.5)
  • Context window: 400K tokens, output: 128K tokens
  • Benchmarks: 56.4% on SWE-Bench Pro

Validation Framework:

• .claude/rules/validation/validation-patterns.md
  • ValidationSeverity (INFO < WARNING < ERROR < CRITICAL)
  • ValidationResult and ValidationReport structure
  • Two-tier validation pattern (check_* vs is_valid_*)

---

Core Capabilities

1. Deep Architecture Planning

Best for: 20-30 minute extended thinking on complex design decisions

When to use:

• Designing new modules or subsystems
• Planning large refactorings
• Evaluating architectural tradeoffs
• Security-critical design decisions

Example prompt structure:

Design a precipitation validation framework for ras-commander.

Requirements:
- Validate HMS-equivalent methods at 10^-6 precision
- Integration with existing ValidationSeverity pattern
- Support multiple precipitation data sources

Context files:
@ras_commander/RasValidation.py
@.claude/rules/validation/validation-patterns.md

Provide:
1. Class structure and responsibilities
2. API design (check_* vs is_valid_* methods)
3. Integration points with existing code
4. Example usage patterns

2. Security Code Review

Best for: Deep security analysis with extended thinking