Codex Subagent Delegation

Prerequisites

以下を実行して前提を確認する。

command -v codex
codex --version
git rev-parse --git-dir

前提を満たさない場合の対応。

• codex が見つからない: インストール手順を案内して中断
• 認証エラー: codex login を案内して中断
• Git リポジトリ外: 警告を出したうえで継続可否を明示

Instructions

Step 1: 要件を委譲プロンプトへ変換

ユーザー依頼を Codex 用に構造化する。

# Task: <短いタスク名>

## Objective
<何を実装するか>

## In Scope
- <対象1>
- <対象2>

## Out of Scope
- <今回やらないこと>

## Constraints
- Follow existing patterns in this repository
- Keep changes minimal and focused
- Add or update tests for changed behavior
- Update docs only if behavior or usage changes
- Do not output full logs or full diffs in your final response
- Keep final response concise and summary-only

## Done Criteria
- Requested behavior is implemented
- Relevant tests pass
- `git status --short` で変更が説明可能

## Final Response Format
- Result: Success | Failed
- Changed Files: max 10 entries
- Test Summary: pass/fail + counts only
- Key Decisions: max 3 bullets
- Remaining Issues: optional, max 3 bullets

Step 2: Codex を実行

--full-auto を既定として Codex に実装を委譲する。

2-A. Subagent 方式（推奨）

• Claude Code の subagent を起動し、Step 1 で作ったプロンプトを渡す。
• subagent 側で codex exec --full-auto を実行し、完了まで自律処理させる。
• 親の Claude は編集を行わず、subagent の完了待機と結果要約のみ行う。

運用ルール:

• subagent には「実装・テスト実行・結果要約」までを担当させる。
• 親 Claude は「監視・失敗時の再委譲判断・ユーザー報告」のみ担当する。

2-B. 直接実行方式（フォールバック）

subagent を使えない環境のみ、次を実行する。

TIMESTAMP="$(date +%Y%m%d%H%M%S)"
PROMPT_FILE="/tmp/codex-prompt-${TIMESTAMP}.md"
RESULT_FILE="/tmp/codex-result-${TIMESTAMP}.txt"

cat > "$PROMPT_FILE" << 'PROMPT'
# Task: <task>

## Objective
<objective>

## In Scope
- <scope>

## Out of Scope
- <out-of-scope>

## Constraints
- Follow existing patterns in this repository
- Keep changes minimal and focused
- Add or update tests for changed behavior
- Update docs only if behavior or usage changes
- Do not output full logs or full diffs in your final response
- Keep final response concise and summary-only

## Done Criteria
- Requested behavior is implemented
- Relevant tests pass
- `git status --short` is explainable

## Final Response Format
- Result: Success | Failed
- Changed Files: max 10 entries
- Test Summary: pass/fail + counts only
- Key Decisions: max 3 bullets
- Remaining Issues: optional, max 3 bullets
PROMPT

codex exec \
  --full-auto \
  --output-last-message "$RESULT_FILE" \
  -C "$(pwd)" \
  - < "$PROMPT_FILE"

EXIT_CODE=$?

Step 3: Claude は監視と完了判定のみ行う

• 実行中は subagent の状態または codex exec のログと終了コードを監視する。
• 成功時は要約結果のみ確認し、ユーザーへ報告する。
• 失敗時は失敗分類に従って再試行または中断する。

git status --short
[ -f "$RESULT_FILE" ] && tail -n 80 "$RESULT_FILE"

ログ取り扱いルール:

• cat で全文を展開しない。
• 会話へ貼るのは「要約に必要な最小行」だけにする。
• 長文ログが必要な場合も、まず 5 行程度の要約を作ってから提示する。

Failure Handling

1) codex 未インストール/未認証

• 症状: command not found または認証エラー
• 対応: codex のインストールまたは codex login を案内して停止

2) 実行エラー（終了コード非0）

• 症状: EXIT_CODE != 0
• 対応: RESULT_FILE の要点のみ報告し、以下のいずれかを選ぶ
  • プロンプトを具体化して再実行
  • スコープを分割して再委譲
  • Claude で方針再整理（実装はしない）

3) 変更が期待と乖離

• 症状: 変更ファイルや内容が要求と合わない
• 対応: 差分の乖離点を明示し、修正指示で Codex を再実行

Reporting Template

Codex 完了後、Claude は次の形式で報告する。

Codex 実装が完了しました。

- Result: Success | Failed (exit code: <code>)
- Changed files: <git status --short の要約>
- Notes: <テスト結果や補足>
- Next action: <必要なら再委譲方針>

Example

User

codexで実装して。ユーザー作成APIに入力バリデーションを追加してテストも更新して。

Claude behavior

1. 要件を Objective / Scope / Constraints / Done Criteria に変換
2. 可能なら subagent を起動して codex exec --full-auto を委譲
3. subagent が使えない場合のみ直接 codex exec --full-auto を実行
4. 実行完了まで監視
5. 変更概要と結果を報告

Limitations

• Codex CLI のインストールと認証が必須
• --full-auto のため、委譲前にスコープ明確化が必須
• 対話前提の実装タスクには不向き
• subagent 機能の有無は実行環境に依存する