product-starter: Command for Claude Code

タスク

Vercel と Supabase のリモート環境をセットアップし、本番デプロイ可能な状態にする。 CLI でできることは CLI で行い、ブラウザ操作が必要な箇所はユーザーに明確に案内する。

各ステップで コマンドの存在確認・ログイン状態確認を行い、未準備なら案内する。ユーザーには進捗を都度報告する。

---

Step 1: Vercel CLI 確認

pnpm vercel --version を実行して確認する。

• 正常にバージョンが表示される → 次のステップへ
• エラーの場合 → vercel がプロジェクトの devDependencies に入っていない。pnpm add -Dw vercel でルートにインストールする

Vercel CLI はプロジェクトの devDependencies で管理する。グローバルインストールは不要。以降のステップでは pnpm vercel で実行する。

Step 2: Vercel ログイン

pnpm vercel whoami でログイン状態を確認する。未ログインの場合:

• 「Vercel にログインします。ブラウザが開くので認証を完了してください」と案内する
• pnpm vercel login を実行する
• アカウントを持っていない場合は「https://vercel.com/signup でアカウントを作成してから再度このコマンドを実行してください」と案内して 終了する

Step 3: Vercel プロジェクトのリンク

.vercel/project.json が存在するか確認する。

• 存在しない場合: ユーザーに「新規プロジェクトを作成しますか？既存プロジェクトにリンクしますか？」と AskUserQuestion で確認する
  • 新規作成: pnpm vercel project add {プロジェクト名} でプロジェクトを作成した後 pnpm vercel link を実行する。プロジェクト名はリポジトリのディレクトリ名をデフォルトとして提案する
  • 既存リンク: pnpm vercel link を実行する（対話プロンプトでユーザーが選択）
• 存在する場合: 「既に Vercel プロジェクトにリンク済みです」と報告してスキップ

Step 4: Vercel プロジェクト設定

Vercel のプロジェクト設定を確認・更新する:

# Root Directory の設定
# pnpm vercel link 時に Root Directory を聞かれるので apps/webapp を指定する
# もし設定が漏れていたら Vercel ダッシュボードでの手動設定を案内する

ユーザーに以下の設定を確認・案内する:

項目	値
Framework Preset	Next.js
Root Directory	apps/webapp
Build Command	pnpm build:vercel
Install Command	pnpm install --frozen-lockfile

これらは pnpm vercel link 時の対話で設定されるが、確認として表示する。もし変更が必要な場合は Vercel ダッシュボード (Settings → General) での変更を案内する。

Step 5: Supabase CLI 確認

pnpm supabase --version を実行して確認する。

• 正常にバージョンが表示される → 次のステップへ
• エラーの場合 → ビルドスクリプトが未許可。ユーザーに「ターミナルで pnpm approve-builds を実行して、supabase にチェックを入れてください。完了後にもう一度このコマンドを実行してください」と案内して 終了する

pnpm approve-builds はインタラクティブなプロンプトのため、自動実行できない。

Step 6: Supabase CLI ログイン

pnpm supabase projects list を実行してログイン状態を確認する。未ログインまたはエラーの場合:

• 「Supabase にログインします」と案内する
• pnpm supabase login を実行する（ブラウザでトークン認証）
• アカウントを持っていない場合は「https://supabase.com/dashboard でアカウントを作成してから再度このコマンドを実行してください」と案内して 終了する