CIとコード所有権
PRで走るチェック、レビューが必要な人、マージが止まる理由。
PRを開くと自動チェックが走り、変更内容によっては開発者の承認がマージ前に必要になります。このページは「何が要求されるか」を先に知っておくための解説です。
すべてのPRで走るチェック
| チェック | ワークフローファイル | 内容 |
|---|---|---|
| PRチェック | .github/workflows/pr-checks.yml | Lint、TypeScript型チェック、影響のあるアプリのビルド、testスクリプトがあればテスト実行。 |
| プレビューデプロイ | .github/workflows/pr-preview-neon.yml + deploy-reusable.yml | Neon DBブランチを作成、スキーマ変更があればマイグレーションを生成、影響のあるアプリをRailwayステージングにデプロイ、プレビューURLをPRコメントに投稿。 |
両方がグリーンにならないとマージできません。ワークフローはpushで自動実行されます。
TypeScriptエラーでビルドが壊れるとチェックが赤くなります — だからこそコミット前に必ずpnpm build:<your-app>をローカル実行しましょう。
開発者レビューが必要なとき
ほとんどのPR — apps/*だけを触るもの — はチェックが通れば即マージできます。しかし一部のパスはCODEOWNERSで保護されていて、開発者の承認が必要です:
| PRが触るもの… | レビュー担当 |
|---|---|
apps/**のみ | チェックがグリーンになれば自動マージ可能 |
shared/database/**, shared/types/**, shared/schema.md | 開発者レビュー必須 |
shared/auth/**, shared/api/** | 開発者のみ（通常Vibe coderは編集しない） |
.github/workflows/deploy-reusable.yml, pr-checks.yml | 開発者のみ |
ルートのpackage.json, CLAUDE.md, README.md | 開発者のみ |
.github/workflows/deploy-app-*.yml | Vibe coderが編集可、追加レビュー不要 |
ソースオブトゥルースは.github/CODEOWNERSです。
期待できる挙動
- アプリコードのみ編集 → チェック実行、プレビューURL投稿、プレビューを自分で確認、グリーンになれば自分でマージ。
- 共有テーブル追加や
schema.md変更 → 上記に加え、開発者の承認が必要。 - CI/ルート設定を触る → 開発者の承認が必要、時間がかかる可能性あり。
マージ後
- 影響のあるアプリが本番に自動デプロイ。
- スキーママイグレーションがNeon mainデータベースに適用。
- PRのNeonプレビューブランチが削除。
Claudeに聞く
変更に必要なレビュアーを確認
Claudeプロンプト(1) meal-plannerアプリに新しいページを追加、(2) shared/database/prisma/schema.prismaのrecipesテーブルに新しいカラムを追加、このPRを開こうとしています。CODEOWNERSに基づいて、マージまでに誰のレビューが必要か教えてください。
クイズ
Quiz
`apps/meal-planner/`配下のファイルだけを編集し、PRチェックが通りました。自分でマージできますか？