AIエージェント前提のWeb開発手順を解説

ガイドの構成は、新しいプロジェクトが実際に進む順序に沿っている。ローカルツール、UIとコード品質の設定、データベース、AI向け指示、リポジトリ、ホスティング、CI/CD、本番設定、初回リリースの順だ。各段階は具体的な確認で締めくくられるため、読者はAIエージェントに機能を書かせる前に環境が動くことを確かめられる。2トラックに分けるのは要求が異なるためだ。SaaSアプリにはルーティング、データベース、認証が必要だが、LPはほぼ静的のままでよい。いずれの場合もマネージドサービスに頼り、独自のAPIサーバーやORMを避けることで、可動部分を少なく保っている。繰り返し現れるテーマは分離だ。本番データを開発環境に入れない、VITE_で始まる環境変数は公開情報として扱う、マイグレーションはフロントエンドのリリースとは別工程で実行する。AGENTS.mdは、AIが生成した変更をこれらの境界内に保つ契約として位置づけられ、エージェントの成果物にはlint、型チェック、テスト、レビューが引き続き適用される。