AGENTS.md 設定ガイド

# プロジェクトルール

## コーディング規約

- TypeScript を使用、any 型は禁止
- 関数名は camelCase
- エラーハンドリングは try-catch で統一

## テスト

- Jest を使用
- カバレッジ 80% 以上を維持
- `npm test` で全テスト実行

## プロジェクト構造

- src/ — ソースコード
- tests/ — テストファイル
- docs/ — ドキュメント

# ~/.codex/AGENTS.md — 全プロジェクト共通

# グローバルルール

- 日本語でコメントを書く
- コミットメッセージは英語
- セキュリティ：ハードコードされた秘密情報を禁止

# ~/my-project/AGENTS.md — このプロジェクト専用

# プロジェクト：My App

## 技術スタック

- Next.js 15 + TypeScript
- Tailwind CSS
- PostgreSQL + Prisma

## コーディング規約

- React コンポーネントは関数コンポーネントで記述
- Server Components をデフォルトで使用
- CSS は Tailwind utility クラスのみ

# ~/my-project/src/api/AGENTS.md — API ディレクトリ専用

# API ルール

- すべてのエンドポイントで入力バリデーションを実施
- Zod スキーマでリクエストを検証
- エラーレスポンスは RFC 7807 形式で統一

# Frontend Rules

## 技術スタック

- React 19 + TypeScript 5.x
- Vite でビルド
- Tailwind CSS v4

## コンポーネント規約

- 関数コンポーネントのみ使用
- Props は interface で型定義（type ではなく）
- ファイル名は PascalCase（例：UserProfile.tsx）

## 状態管理

- ローカル状態：useState / useReducer
- サーバー状態：TanStack Query
- グローバル状態：Zustand（必要な場合のみ）

## テスト

- Vitest + Testing Library
- `npm test` で実行

# Backend Rules

## 技術スタック

- Python 3.12 + FastAPI
- SQLAlchemy 2.0 + Alembic
- PostgreSQL

## コーディング規約

- 型ヒントを必ず使用
- async/await を優先
- Pydantic v2 でバリデーション

## API 設計

- RESTful 設計原則に従う
- OpenAPI スキーマを自動生成
- エラーレスポンスは統一フォーマット

## テスト

- pytest + httpx
- `pytest -xvs` で実行