---

name: vercel-subdomain description: 新しいVercelプロジェクトにcraftgarden.studioサブドメインを設定する。「サブドメイン設定」「ドメイン追加」「Vercelにドメイン」「craftgarden設定」などのトリガーで発火。

Vercel Domain Setup

新しいサービスをVercelにデプロイした際に、{repo-name}.craftgarden.studio のサブドメインを自動設定するスキル。

⚠️ 重要: craftgarden-studio リポジトリは例外 craftgarden-studio はルートドメイン craftgarden.studio に直接デプロイされる。 サブドメインを振ってはいけない。詳細は「特殊ケース: ルートドメイン」セクションを参照。

前提条件

• AWS CLI が設定済み（Route 53 操作権限あり）
• Vercel CLI がログイン済み
• craftgarden.studio のホストゾーンが Route 53 に存在

設定値

項目	値
ベースドメイン	craftgarden.studio
Route 53 Hosted Zone ID	Z02122701AQ4170J8PPI9
Vercel Team ID	team_E5XdgBN4vG4cYvPQ6cCA0jeR
CNAME Target	cname.vercel-dns.com

Note: 旧ドメイン craftgarden.studio (Zone ID: Z0907557Q15UOJ6IWK4J) も引き続き有効

ワークフロー

Step 1: リポジトリ名の確認

ユーザーにリポジトリ名（= サブドメイン名）を確認する。 命名規則: リポジトリ名がそのままサブドメインになる

例: リポジトリ my-new-app → my-new-app.craftgarden.studio

Step 2: Vercel プロジェクトIDの取得

プロジェクト一覧取得スクリプトを実行:

~/.openclaw/skills/vercel-subdomain/scripts/list-projects.sh

Step 3-5: サブドメイン設定（Vercelドメイン追加 + Route 53 CNAME + 確認）

一括設定スクリプトを実行:

~/.openclaw/skills/vercel-subdomain/scripts/setup-subdomain.sh <リポジトリ名> <プロジェクトID>

スクリプトは以下を自動実行:

1. Vercel にカスタムドメインを追加
2. Route 53 に CNAME レコードを追加
3. DNS伝播確認 + Vercelドメインステータス確認

SSL証明書はVercelが自動発行（数分かかる場合あり）。

Step 6: 結果報告

設定完了後、以下を報告:

• サブドメイン: https://{repo-name}.craftgarden.studio
• DNS ステータス
• Vercel ドメイン登録ステータス

特殊ケース: ルートドメイン（craftgarden-studio）

craftgarden-studio リポジトリだけはサブドメインではなく、ルートドメイン craftgarden.studio に直接デプロイする。

通常のサブドメインワークフロー（Step 1〜6）は使わない。代わりにルートドメイン設定スクリプトを使用:

~/.openclaw/skills/vercel-subdomain/scripts/setup-root-domain.sh <プロジェクトID>

注意: ルートドメイン（apex domain）は CNAME を使えないため、Vercel の IP 76.76.21.21 への A レコードを使用する。

既存サブドメイン一覧

リポジトリ	サブドメイン
craftgarden-studio	craftgarden.studio（ルート）
product-hub (dashboard)	product-hub.craftgarden.studio
ai-pm-service	ai-pm-service.craftgarden.studio
ai-solo-craft	ai-solo-craft.craftgarden.studio
content-studio	content-studio.craftgarden.studio
feedback-hub	feedback-hub.craftgarden.studio
competitor-ui-viewer	competitor-ui-viewer.craftgarden.studio
conf-hub	conf-hub.craftgarden.studio
orcha	orcha.craftgarden.studio
history-quiz-app	history-quiz-app.craftgarden.studio
essential-navigator	essential-navigator.craftgarden.studio
agent-skill-search	agent-skill-search.craftgarden.studio
api-catalog-jp	api-catalog-jp.craftgarden.studio

⚠️ よくある落とし穴

• craftgarden-studioリポジトリにサブドメインを設定してしまう: craftgarden-studio はルートドメイン craftgarden.studio に直接デプロイする特殊ケース。サブドメインワークフロー（Step 1〜6）は使わず、ルートドメイン設定手順に従うこと
• ルートドメインにCNAMEレコードを使う: apex domain（craftgarden.studio）はCNAMEを設定できない。Vercel の IP 76.76.21.21 への A レコードを使用する
• ドメインが解決しない: DNS伝播には最大48時間かかる場合がある（通常は数分）。dig で CNAME が返るか確認する
• Vercelで "Invalid Configuration" と出る: CNAMEレコードが cname.vercel-dns.com を向いているか、Vercel側のドメイン設定で verification が完了しているか確認する
• SSL証明書エラー: Vercelが自動でLet's Encrypt証明書を発行するが、DNS伝播完了後に数分かかる場合がある。すぐにHTTPSアクセスできなくても待つ