AGENTS.md の書き方

# プロジェクト名

一行でこのリポジトリが何かを書く。技術構成もここに1行で。
例: Next.js 16 (App Router) + React 19 + Tailwind の社内向け業務ツール。

## コマンド
- `npm run dev` — 開発サーバー起動
- `npm run build` — 本番ビルド（PR前に必ず通す）
- `npm run lint` — ESLint
- `npm test -- <path>` — 単体テスト（全体実行は時間がかかるので範囲を指定する）

## ディレクトリ規約
- `app/` — 画面とAPIルート
- `components/` — 共有UI（1ファイル1コンポーネント）
- `lib/` — 副作用のないユーティリティ
- `data/` — 表示用の静的データ

## 触らないディレクトリ（読取のみ）
- `_private/` — 非公開データ
- `_archive/` — 過去の保管物
- `.tmp/` — 一時ファイル

指示がない限り、上記の編集・削除・移動をしない。

## コーディング規約
- TypeScript。関数コンポーネントのみ。
- 既存ファイルの命名・記法に合わせる。新しい書き方を持ち込まない。
- 新規依存の追加は、既存で実現できないと確認してからにする。
- コメントは「なぜ」を書く。「何をしているか」はコードで示す。

## 完了の条件
- `npm run build` と `npm run lint` が通ること。
- 変更したファイルだけをコミットすること。
- コミットメッセージは日本語、1行目は50文字以内。

## やってはいけないこと
- `.env` および認証情報をコミットしない。
- main ブランチに直接コミットしない。
- 既存のテストを、通すために書き換えない。

# 社内見積もりツール

Next.js + TypeScript。社内利用のみ。

## コマンド
- `npm run dev` / `npm run build` / `npm run lint`

## ルール
- `_private/` は読むだけ。編集しない。
- 変更後は必ず `npm run build` を通す。
- 金額計算のロジックは `lib/price.ts` に集約する。

repo/
├─ AGENTS.md              # 全体共通（コミット規約、禁止事項）
├─ apps/
│  ├─ web/
│  │  └─ AGENTS.md        # フロント固有（Tailwind規約、コンポーネント方針）
│  └─ api/
│     └─ AGENTS.md        # API固有（マイグレーション手順、認証の扱い）
└─ packages/
   └─ ui/
      └─ AGENTS.md        # 共有UI固有（破壊的変更の禁止など）