# AGENTS.md

AI コーディングエージェント向けのプロジェクトガイドラインです。

> **重要**: 詳細なガイドラインは `CLAUDE.md` を参照してください。

## プロジェクト概要

<!-- プロジェクトの概要を記述 -->

- **プロジェクト名**: <!-- プロジェクト名 -->
- **説明**: <!-- プロジェクトの目的・概要 -->
- **技術スタック**: <!-- 使用する主要技術 -->
- **アーキテクチャ**: <!-- アーキテクチャパターン -->

## ディレクトリ構成

<!-- 主要なディレクトリ構成を記述 -->

```
.
├── src/                # ソースコード
├── tests/              # テストコード
├── docs/               # ドキュメント
└── ...
```

## ビルド・テストコマンド

<!-- プロジェクトで使用するコマンドを記述 -->

```bash
# 依存関係インストール
# npm install / pip install -r requirements.txt / ./gradlew build

# 開発サーバー起動
# npm run dev / python manage.py runserver

# テスト実行
# npm test / pytest / ./gradlew test

# Lint 実行
# npm run lint / flake8 / ./gradlew check
```

## 環境操作（ステージング・プロダクション）

ステージング・プロダクションへの操作（**DB 接続・クエリ**・バックアップ・デプロイ・プロビジョニング）は、**先に `docs/operation/` の運用手順書を読み、定義済みのタスクを使う**。手順があるのに独自の一時スクリプトを書かない。

- 手順書のタスクは踏み台の IP 追従・鍵・認証情報・ポート・環境変数の読み込みを解決済み。独自スクリプトはそれを再実装することになり、設定の読み漏れで無駄に失敗する
- **運用スクリプトの置き場（`ops/scripts/` 等）に一時ファイルを置かない。** 調査用の使い捨てはスクラッチパッドに置き、作業後に消す
- 手順書に無い操作が必要なら既存タスクを探し、無ければ `operating-script` スキルで正式なタスクとして追加して手順書にも記載する

## コード規約

### 言語・スタイル

- **日本語**でコミュニケーション（技術用語は英語）
- 日本語と半角英数字の間に**半角スペース**を入れる
- **ですます調**、句読点は「。」「、」

### プロジェクト固有のルール

<!-- プロジェクト固有のコーディングルールを記述 -->

- フォーマッター: <!-- Prettier / Black / Checkstyle など -->
- リンター: <!-- ESLint / Flake8 / Checkstyle など -->
- その他: <!-- パスエイリアス、命名規則など -->

## テスト指示

- **TDD サイクル**に従う: Red → Green → Refactor
- テストが通る状態でのみコミット
- テストフレームワーク: <!-- Jest / Vitest / pytest / JUnit など -->

## コミット規約

- **Conventional Commits** 形式を使用
- 構造変更と動作変更を同一コミットに含めない
- 日本語でコミットメッセージを記述

```
feat: 新機能を追加
fix: バグを修正
docs: ドキュメントを更新
refactor: リファクタリング
test: テストを追加
chore: ビルド・設定変更
```

## PR 指示

- すべてのテストがパスしていること
- Lint エラーがないこと
- 変更内容を簡潔に説明

## 参照ドキュメント

<!-- プロジェクトの参照ドキュメントを記述 -->

- `CLAUDE.md` - 詳細な AI エージェント実行ガイドライン
- <!-- その他の参照ドキュメント -->