AGENTS.mdテンプレート集：Next.js・Rails・FastAPI・Go・Astro のスタック別雛形

# AGENTS.md — Next.js (App Router)

## Commands
- dev: `npm run dev`（= next dev。HMR 付き。開発ビルドは .next/dev に出る）
- build: `npm run build`（= next build。出力の Route 一覧で新規ルートが Static / Dynamic どちらか確認する）
- start: `npm run start`（= next start。必ず build 後）
- 型検査: `npx next typegen && npx tsc --noEmit`（ルート型を生成してから tsc）
- lint: `npx eslint .`（設定は eslint.config.mjs。`next lint` は現行 CLI に無いので使わない）

## Layout
- `app/` … App Router。フォルダ = URL セグメント。`page.tsx` か `route.ts` を置いた時点で公開ルートになる
- `app/**/layout.tsx` … 共有 UI。`loading` `error` `not-found` `template` `default` は予約名
- `app/**/_components/` `_lib/` … アンダースコア始まりはルーティング対象外（コロケーション用）
- `(group)/` … URL に出ないグループ。`@slot/` はパラレルルート
- `public/` … 静的ファイル。`src/` を使う構成では `app/` も `src/` 配下
- `proxy.ts` … リクエストプロキシ。`instrumentation.ts` … 計測。どちらもルート直下

## Testing
- 新しいルートを足したら `npm run build` を通し、出力の Route 一覧に載ることを確認する
- テストランナーは package.json の `test` スクリプトに従う（未設定なら追加前に相談）
- 型を触ったら `npx next typegen && npx tsc --noEmit` を通す

## Do not
- `.env` `.env.local` `.env.production` `.env.development` `next-env.d.ts` をコミットしない
- `app/` 配下に予約名と衝突する独自ファイルを作らない（`page.ts` を「ページ一覧ユーティリティ」に使うなど）
- `next.config.js` の変更は理由を PR 本文に書く
- `.next/` を手で触らない

## PR rules
- 1 PR = 1 ルートまたは 1 機能。`next build` の Route 一覧の差分を PR に貼る
- Server Component / Client Component の境界を変えたら PR 本文に明記する

# AGENTS.md — Ruby on Rails

## Commands
- server: `bin/rails server`
- console: `bin/rails console`
- generate: `bin/rails generate <model|controller|migration> ...`（生成物の diff を確認し、不要ファイルは削る）
- migrate: `bin/rails db:migrate`（test 環境は `bin/rails db:migrate RAILS_ENV=test`）
- test: `bin/rails test`（1ファイル: `bin/rails test test/models/article_test.rb`、行指定: `...:6`）
- system test: `bin/rails test:system`。全部: `bin/rails test:all`
- lint: `bin/rubocop`（設定は .rubocop.yml）
- routes: `bin/rails routes`

## Layout
- `app/` … controllers / models / views / helpers / mailers / jobs / assets
- `config/` … routes.rb、database.yml、環境設定。`config.ru` は Rack 起動用
- `db/` … スキーマとマイグレーション。`db/schema.rb` は migrate が生成する
- `lib/` … アプリの拡張モジュール。`script/` … 一回きりのスクリプト
- `test/` … models / controllers / integration / system / fixtures / helpers / mailers。共通設定は test/test_helper.rb
- `storage/` … SQLite と Active Storage（Disk）。`tmp/` `log/` は生成物

## Testing
- モデルを触ったら `test/models/`、コントローラなら `test/controllers/` を同じ PR で更新する
- fixture を変えたら `bin/rails test test/models` で関連テストを全部回す
- `bin/rubocop` が通らない差分は完了扱いにしない

## Do not
- `db/schema.rb` を直接編集しない。マイグレーションを追加する
- マージ済みのマイグレーションを書き換えない。新しいマイグレーションで直す
- `config/master.key` `config/credentials/*.key` `.env` をコミットしない
- `storage/` `tmp/` `log/` の中身をコミットしない
- `Gemfile` への gem 追加は事前に相談する（`Gemfile.lock` の差分も PR に含める）

## PR rules
- マイグレーションを含む PR は本文にロールバック手順を書く
- `bin/rails test` と `bin/rubocop` の結果を PR 本文に貼る

# AGENTS.md — FastAPI (Python)

## Commands
- dev: `uv run fastapi dev`（エントリポイントは pyproject.toml の [tool.fastapi] entrypoint = "app.main:app"。直接指定は `uv run fastapi dev app/main.py`）
- test: `uv run pytest`（TestClient は httpx が必要: `uv add httpx`）
- 依存追加: `uv add <pkg>`（pip / poetry のプロジェクトは該当コマンドに読み替える）

## Layout
- `app/__init__.py` … app をパッケージにする（消さない）
- `app/main.py` … `FastAPI()` 本体。ルーターは `app.include_router(...)` で集約する
- `app/dependencies.py` … 共有の Depends（トークン検証など）
- `app/routers/<resource>.py` … `APIRouter(prefix=..., tags=[...])` を 1 リソース 1 ファイル
- `app/internal/` … 管理系など外部公開しないルーター
- テスト … 公式チュートリアルは `app/test_main.py`。本リポジトリでは `tests/` を正とする

## Testing
- ルートを足したら `TestClient` のテストを同じ PR に含める
  （`from fastapi.testclient import TestClient`、関数は `def test_...`。`async def` にしない）
- `uv run pytest` が緑でない差分は完了扱いにしない

## Do not
- `app/main.py` にパスオペレーションを直書きしない。`routers/` に置いて include_router する
- `prefix` / `tags` / `dependencies` を router 側と include_router 側の両方に書かない（二重付与）
- `.env` `*.pem` `secrets/` をコミットしない
- `uvicorn` を直接叩く起動手順を増やさない（`fastapi dev` に統一）

## PR rules
- 新しいエンドポイントは `/docs`（OpenAPI）で確認した結果か curl 例を PR に貼る
- レスポンスモデルを変えたら、破壊的変更かどうかを PR タイトル冒頭に書く

# AGENTS.md — Go

## Commands
- build: `go build ./...`
- test: `go test ./...`（1パッケージ: `go test ./internal/auth/`）
- tidy: `go mod tidy`（依存を触ったら必ず。go.sum の差分も PR に含める）
- vet / format: `go vet ./...`、`gofmt -l .`（出力が空で完了）
- install: `go install ./cmd/<prog>`。ローカル確認は `go build -o bin/<prog> ./cmd/<prog>`

## Layout
- `go.mod` … モジュールパス（`module github.com/<org>/<name>`）。変えると import が全部壊れる
- `cmd/<prog>/main.go` … 実行バイナリごとに 1 ディレクトリ。`package main` はここだけ
- `internal/` … 外部から import できないパッケージ。サーバーのロジックは原則ここ
- ルート直下の `*.go` … 公開パッケージ（ライブラリとして import させるものだけ）
- `*_test.go` … テストは同じパッケージ内に置く（`func TestXxx(t *testing.T)`）

## Testing
- 変更したパッケージの `go test` を回し、`go vet ./...` を通す
- 新しい `cmd/` を足したら `go build ./...` が通ることを確認する

## Do not
- `pkg/` を新設しない（公式レイアウトに無い。公開したいものはルート直下、隠すものは internal/）
- `vendor/` を勝手に作らない（`go mod vendor` の採否はチームで決める）
- `go.sum` を手で編集しない
- `cmd/` 配下に共有ロジックを書かない（`internal/` に寄せる）

## PR rules
- 公開 API（ルート直下のパッケージ）のシグネチャ変更は影響範囲を PR 本文に書く
- `go test ./...` と `go vet ./...` の結果を PR に貼る

# AGENTS.md — Astro

## Commands
- dev: `npm run dev`（= astro dev）
- build: `npm run build`（= astro build。dist/ に出力）
- preview: `npm run preview`（= astro preview。build 後の dist/ を配信）
- check: `npx astro check`（.astro の型検査。PR 前に必ず）
- sync: `npx astro sync`（content collections の型を再生成。スキーマを触ったら実行）

## Layout
- `src/pages/` … 唯一の予約ディレクトリ。ファイル = ルート。`*.ts` で GET を export すると静的エンドポイント（例: `llms.txt.ts` → /llms.txt）
- `src/components/` `src/layouts/` … 再利用部品と共通枠
- `src/content/` … content collections。スキーマは `src/content.config.ts`
- `public/` … ビルドを通さずそのままコピーされる（robots.txt、_headers など）
- `astro.config.mjs` … site / integrations。`site` を変えると sitemap と RSS の URL が変わる

## Testing
- UI を触ったら `npm run dev` で該当ページを開いて目視してから完了にする
- frontmatter を触ったら `npx astro check` で content schema のエラーが 0 か確認する

## Do not
- `dist/` `.astro/` `node_modules/` をコミットしない
- `src/pages/` に「ページのつもりではない」ファイルを置かない（全部ルートになる）
- content collection のスキーマ変更は既存記事全件に影響する。`astro check` を通さずにマージしない
- `public/_headers` はルールが結合される。既存ルールの上書きを期待しない

## PR rules
- 記事追加は frontmatter（title / description / pubDate / category / tags）を埋めてから
- ビルド警告（未解決 import、存在しないコンポーネント）を PR で潰す