OpenAI Codex 実践ガイド

codex

# まずは現状把握
> このリポジトリの構成、ビルド方法、主要な制約を要約してください

# ルールを外出し
touch AGENTS.md

# 次に AGENTS.md の初稿作成を依頼
> このリポジトリ向けに AGENTS.md の初稿を作ってください。
> 含めたいのは coding rules、test command、deploy 禁止事項、review 観点です。

Goal:
会員ダッシュボードの請求カードに「次回請求日」を表示したい

Context:
- Next.js App Router
- 対象は src/components/dashboard/BillingCard.tsx
- 既存 API は変更しない

Constraints:
- UI の大幅改変はしない
- 型 safety を崩さない
- 既存の loading / error 状態を維持する

Done when:
1. 表示ロジックが追加されている
2. type-check が通る
3. 影響範囲を短く説明できる

# Project Rules
- Use TypeScript and preserve existing App Router patterns
- Prefer small diffs over broad rewrites
- Run `npm run type-check` after touching app code
- Do not change deploy scripts or production env files

# Review Checklist
- Check loading / empty / error states
- Keep metadata and navigation intact
- Do not edit unrelated files

# Communication
- Explain impact before editing
- Summarize changed files and verification at the end

Goal:
特定条件でモーダルが閉じない不具合を修正したい

Context:
- 再現手順: ...
- 対象候補: src/components/.../Modal.tsx
- 関連 state: isOpen, pendingAction

Ask:
1. 原因仮説を 3 つ
2. 最も筋の良い修正方針
3. 影響範囲
4. 修正後に実行する確認項目

Code only after the plan is accepted.

1. 何の手作業を消すのか
2. 読み取り専用で足りるか
3. どの surface から使うか
4. 失敗時に人間がどう介入するか
5. AGENTS.md に利用方針を書くか

- design review
- migration checklist
- API contract review
- accessibility pass
- deployment verification
- analytics QA

git worktree add ../quadnewweb-review codex/review-pass
git worktree add ../quadnewweb-feature codex/dashboard-billing

# review 用 Codex
cd ../quadnewweb-review && codex

# implementation 用 Codex
cd ../quadnewweb-feature && codex

対象:
昨日 merge された変更

やること:
1. 差分を要約
2. リスクを 3 点抽出
3. docs 更新漏れを確認
4. 必要なら inbox item を作る

禁止:
- 自動 commit しない
- deploy しない
- 本番設定を変えない

この変更をコードレビューしてください。

重点観点:
1. バグや回帰
2. 型・状態管理の不整合
3. エッジケース漏れ
4. テスト不足

出力形式:
- Findings を重要度順に
- Open questions
- 変更概要は最後に短く