Codex: Codex ルールとフック

# AGENTS.md

## プロジェクト概要
プロジェクト名：E-Commerce API
技術スタック：FastAPI + PostgreSQL + Redis
コード規格：PEP 8 + Black フォーマッター

## コードルール
- すべての関数に型アノテーションを含める
- すべての API エンドポイントに入力バリデーションを含める
- 依存性注入を使用
- エラー処理にはカスタム例外クラスを使用

## ファイル構造
- src/api/ - API ルート
- src/models/ - データモデル
- src/services/ - ビジネスロジック
- src/tests/ - テストファイル

## 禁止操作
- .env ファイルを変更しない
- 既存のテストを削除しない
- 新しい依存関係をインストールしない（手動確認が必要）
- database/migrations/ の既存の移行を変更しない

# AGENTS.md

## プロジェクト概要
Next.js 14 eコマースサイト、App Router + TypeScript + Prisma を使用

## コードルール
- コンポーネントは関数コンポーネント + TypeScript
- API ルートの代わりに server actions を使用
- データ取得には RSC（React Server Components）を使用
- スタイリングには Tailwind CSS
- フォームには React Hook Form + Zod バリデーション

## ディレクトリ規約
- app/ - ページとルート
- components/ - 再利用可能なコンポーネント
- lib/ - ユーティリティ関数と設定
- types/ - TypeScript 型定義

## 禁止操作
- 必要がない限り 'use client' を使用しない
- 新しい UI ライブラリをインストールしない（既存の shadcn/ui を使用）
- prisma/schema.prisma の既存モデルを変更しない（追加のみ）
- middleware.ts を変更しない

# .codex/config.toml

[hooks]
# タスク完了後に自動的にテストを実行
post-task = "npm test"

# コミット前に自動フォーマット
pre-commit = "npm run format && npm run lint"

# エラー時に通知を送信
on-error = "curl -X POST https://hooks.slack.com/xxx -d 'Codex error'"

# .codex/hooks/post-task.sh
#!/bin/bash

# テストを実行
npm test
if [ $? -ne 0 ]; then
  echo "Tests failed! Fixing..."
  codex --full-auto "Fix all failing tests"
fi

# コードをフォーマット
npm run format

# lint をチェック
npm run lint

# Bob のフック設定
[hooks]
post-task = "bash .codex/hooks/post-task.sh"

# .codex/hooks/post-task.sh
#!/bin/bash
npm test                    # テストを実行
npm run lint -- --fix       # lint を修正
npm run format              # フォーマット
echo "Hook: post-task completed"

project/
├── AGENTS.md              # グローバルルール
├── src/
│   ├── AGENTS.md          # src ディレクトリのルール
│   ├── api/
│   │   └── AGENTS.md      # API モジュールのルール
│   └── auth/
│       └── AGENTS.md      # Auth モジュールのルール

サブディレクトリ AGENTS.md > 親ディレクトリ AGENTS.md > ルート AGENTS.md

<!-- src/api/AGENTS.md -->
# API モジュールルール
- すべてのエンドポイントに Swagger ドキュメントを含める
- リクエスト/レスポンスのバリデーションに Pydantic を使用
- 標準レスポンスフォーマットを返す：{ data: ..., error: ... }

AGENTS.md サブディレクトリ > AGENTS.md ルート > スキル > 設定ファイル > デフォルト動作