smart-friend

name	smart-friend
description	A knowledgeable neighbor who offers a fresh perspective on architecture, design decisions, and test strategy. Use proactively when a second opinion would improve quality, or when the user says "別の視点が欲しい", "設計を相談したい", "相談", "smart-friend に聞いて", or asks for feedback on their approach.

smart-friend: External AI Design Reviewer

Codex CLI (codex exec) を使って、設計やテスト戦略について外部 AI から独立したレビューを得る。 Claude 単独では得られない「別の視点」を提供することが目的。

使い方

codex exec --sandbox read-only -m gpt-5.4 "<prompt>"

プロンプトが長い場合や $ やバッククォートを含む場合は、heredoc で stdin から渡す:

cat <<'EOF' | codex exec --sandbox read-only -m gpt-5.4 -
<prompt>
EOF

プロンプトの組み立て方

レビュー対象と観点を明確にしたプロンプトを組み立てる。 Codex はワーキングディレクトリのファイルを読めるので、関連ファイルを読むよう指示する。

構成:

1. コンテキスト: 関連ファイルを読む指示（DESIGN.md、ソースコードなど）
2. レビュー対象: ユーザーの提案や設計案を具体的に記述
3. レビュー観点: 何を見てほしいか

例:

以下の設計提案をレビューしてください。

## コンテキスト
DESIGN.md を読んで、プロジェクトの全体設計を把握してください。

## レビュー対象
BusAccessor trait の API 設計として以下を検討しています:
<ユーザーの提案>

## レビュー観点
- DESIGN.md の方針との整合性
- 見落としているエッジケースや懸念点
- 代替案があればその trade-off

レビュー結果の扱い方

Codex のレビュー結果を受けて、状況に応じた対応を取る:

• 指摘がもっともで即座に対応できる場合: レビュー内容を要約してユーザーに伝えつつ、修正を進める
• 議論が必要な指摘の場合: Codex の意見と自分（Claude）の見解を両方提示し、ユーザーと議論する
• 意見が分かれる場合: 両方の視点と trade-off を整理して、ユーザーの判断を仰ぐ

重要なのは、Codex の回答を鵜呑みにせず、自分の視点も持った上で建設的に扱うこと。

注意事項

• 必ず --sandbox read-only を付けてファイル変更を防ぐ
• codex の実行には時間がかかることがある。Bash の timeout は 300000 (5分) を設定する
• ユーザーが別のモデルを指定した場合はそれに従う