create-einja-app 0.3.1 → 0.3.3

package/templates/default/docs/plans/warm-hopping-lighthouse-agent-a90b809.md

@@ -0,0 +1,421 @@
+# infra-maintenance Skill 現状適合性分析報告書
+
+## 調査サマリー
+
+**調査日**: 2026-03-03
+**調査対象**: `.claude/skills/einja-infra-maintenance/SKILL.md`
+**結論**: **概ね現状に適合しているが、一部細部での乖離と欠落がある**
+
+---
+
+## 1. 調査範囲と方法
+
+以下のドキュメント群を全文読み込み、Skill内で参照されている情報との整合性を検証しました。
+
+### 1.1 設計方針ドキュメント
+- `docs/einja/steering/infrastructure/environment-variables.md`
+- `docs/einja/steering/infrastructure/deployment.md`
+
+### 1.2 手順書ドキュメント
+- `docs/einja/instructions/environment-setup.md`
+- `docs/einja/instructions/deployment-setup.md`
+- `docs/einja/instructions/vercel-cli-reference.md`
+- `docs/einja/instructions/neon-cli-reference.md`
+- `docs/einja/instructions/local-server-environment-and-worktree.md`
+
+### 1.3 その他
+- `docs/einja/steering/development/database-guidelines.md`
+- ルート・apps/web・packages/server-core の `package.json`
+- `.github/workflows/deploy-stable-branches.yml`
+- `.github/workflows/deploy-pr-preview.yml`
+- `.github/actions/setup/action.yml`
+- `.github/actions/ci/action.yml`
+- `packages/server-core/prisma/schema.prisma`
+
+---
+
+## 2. 適合性評価（カテゴリ別）
+
+### ✅ 現状適合している項目
+
+#### カテゴリ1: ローカル環境セットアップ
+- `pnpm dev:setup` / `pnpm dev:bg` / `pnpm dev:stop` の存在確認: ✅（package.json）
+- エラー診断表（.env.keys不在、PostgreSQL接続エラー等）: ✅（local-server-environment-and-worktree.md と一致）
+- 参照ドキュメント: ✅（全て実在）
+
+#### カテゴリ2: 環境変数管理
+- ファイル構成（.env.local/develop/production/preview）: ✅（environment-variables.md と一致）
+- dotenvx encrypt/decrypt フロー: ✅（environment-setup.md と一致）
+- .env.personal のセキュリティ設定（chmod 600）: ✅（environment-setup.md に記載）
+- 参照ドキュメント: ✅
+
+#### カテゴリ3: Vercel管理
+- CLIコマンド（vercel link/env/deploy）: ✅（vercel-cli-reference.md と一致）
+- Root Directory設定（API PATCH方式）: ✅（vercel-cli-reference.md と一致）
+- 環境変数同期の設計意図: ✅（deployment.md「Vercel環境変数の自動同期」と一致）
+- 参照ドキュメント: ✅
+
+#### カテゴリ4: Neon管理
+- `neonctl auth` 不使用の理由: ✅（neon-cli-reference.md「認証」セクションと一致）
+- `--api-key` フラグまたは `NEON_API_KEY` 環境変数による認証: ✅
+- ブランチ作成・削除・接続文字列取得コマンド: ✅（neon-cli-reference.md と一致）
+- 参照ドキュメント: ✅
+
+#### カテゴリ5: GitHub Secrets管理
+- `gh secret list/set` コマンド: ✅
+- dotenvx秘密鍵一括設定スクリプト: ✅（deployment-setup.md「GitHub Secrets登録」と一致）
+- 参照ドキュメント: ✅
+
+#### カテゴリ6: 環境状態確認
+- ヘルスチェック項目（CLI存在確認、Docker状態等）: ✅（local-server-environment-and-worktree.md「包括的ヘルスチェック」と一致）
+- 推奨アクション提案ロジック: ✅（合理的）
+- 参照ドキュメント: ✅
+
+#### カテゴリ7: GitHub Actions CI/CD管理
+- ワークフロー一覧表: ✅（実際のワークフローと一致）
+- `gh run list/view` コマンド: ✅
+- トリガータイプ（push, PR, schedule, manual）: ✅（各ワークフローと一致）
+- 参照ドキュメント: ✅
+
+---
+
+### ⚠️ 細部で乖離がある項目
+
+#### 2.1 GitHub Actions: バージョン情報の古さ
+
+**現状のSkill記載**: バージョン情報なし
+**実際のワークフロー**:
+- `actions/checkout@v4` ✅
+- `pnpm/action-setup@v4` ✅
+- `actions/setup-node@v4` ✅
+- `actions/github-script@v7` ✅
+- `actions/upload-artifact@v4` ✅
+- `actions/download-artifact@v4` ✅
+- `neondatabase/create-branch-action@v6` ✅
+- `dorny/paths-filter@v3` ✅
+
+**影響**: Skillには最新バージョン情報が反映されていないが、Skillは「ワークフロー管理」であり「action自体の編集」は対象外のため、**実用上の問題はない**。
+
+**推奨アクション**: Skillには「actionバージョンはワークフローファイルを参照」と記載しているため、現状維持でOK。
+
+---
+
+#### 2.2 Node.js / pnpm バージョン
+
+**現状のSkill記載**: 明示なし
+**実際の設定**:
+- Node.js: 22.16.0（`package.json volta` / `.github/actions/setup/action.yml`）
+- pnpm: 10.14.0（同上）
+
+**影響**: カテゴリ1「エラー時の対処」でバージョン不一致時に `volta install node@22` と記載があるが、**具体的なバージョン番号（22.16.0）が記載されていない**。
+
+**推奨アクション**: Skillの「エラー時の対処」テーブルに以下を明記:
+```
+| Node.jsバージョン不一致 | `volta install node@22.16.0` 提案 |
+| pnpmバージョン不一致 | `volta install pnpm@10.14.0` 提案 |
+```
+
+---
+
+#### 2.3 Prisma / DB設定
+
+**現状のSkill記載**: `pnpm db:generate`, `pnpm db:push`, `pnpm db:migrate` 等の言及あり
+**実際の設定**:
+- Prisma Client: 6.10.1（packages/server-core/package.json）
+- DB: PostgreSQL（schema.prisma）
+- **Drizzleは使用していない**（検索結果ゼロ）
+
+**影響**: Skillでは「Prisma」を前提としており、**Drizzle言及は不要**。現状のSkillは正しい。
+
+**推奨アクション**: 変更不要。
+
+---
+
+#### 2.4 環境変数: `.env.develop` の存在確認
+
+**現状のSkill記載**: カテゴリ2で `.env.develop` を対象に含める
+**実際のドキュメント**:
+- environment-variables.md: `.env.develop` は「dev検証サーバー用」として定義済み ✅
+- deployment.md: developブランチは `.env.develop` を使用 ✅
+
+**影響**: なし。正しく整合している。
+
+---
+
+#### 2.5 Vercel環境変数同期の設計変更（2024年以降）
+
+**現状のSkill記載**（カテゴリ3）:
+```
+> **注意**: CI/CDではmainブランチのみ`vercel env add`で自動同期。develop/staging/PRは`--env`実行時注入。
+> 以下の手動同期は**初回セットアップ時のみ**実行。
+```
+
+**実際のワークフロー**:
+- `deploy-stable-branches.yml` (L202-L220): mainブランチのみ `vercel env add` で同期 ✅
+- `deploy-stable-branches.yml` (L237-L261): すべてのブランチで `vercel deploy --env` による実行時注入 ✅
+- `deploy-pr-preview.yml` (L274-L300): `vercel deploy --env` による実行時注入のみ（`vercel env add` 不使用） ✅
+
+**影響**: Skillの記載は**正確**。ドキュメントと整合している。
+
+---
+
+#### 2.6 Neon環境変数の管理場所
+
+**現状のSkill記載**（カテゴリ4）:
+```
+3. NEON_PROJECT_IDを`.env.preview`に設定 → dotenvx暗号化
+```
+
+**実際のドキュメント**:
+- environment-variables.md (L168-L179): NEON_API_KEY と NEON_PROJECT_ID は `.env.preview` で管理 ✅
+- deployment.md (L532-L534): NEON_* は除外対象（環境変数同期から除外） ✅
+
+**影響**: なし。正しく整合している。
+
+---
+
+#### 2.7 データベース設計ガイドラインの反映
+
+**Skillへの反映**: なし
+**実際のガイドライン**:
+- `docs/einja/steering/development/database-guidelines.md` は存在するが、infra-maintenance Skillの「参照ドキュメント」に含まれていない。
+
+**影響**: infra-maintenanceはインフラ環境の**セットアップ・メンテナンス**を担当し、**Prismaスキーマ編集**は対象外。よって、database-guidelines.mdはbackend-architect等のコーディング系Skillが参照すべき。
+
+**推奨アクション**: 変更不要（Skillのスコープ外）。
+
+---
+
+### ❌ 欠落している項目
+
+#### 3.1 `pnpm env:update` コマンドの言及
+
+**現状のSkill記載**: カテゴリ2で「個人トークン設定」「チーム共有設定変更」を手動フローで記載
+**実際のドキュメント**:
+- environment-setup.md (L62-L69): `pnpm env:update` は対話式ウィザードで環境変数設定を案内 ✅
+- package.json (L44): `"env:update": "tsx scripts/env.ts"` ✅
+
+**影響**: Skillでは `dotenvx decrypt` → 手動編集 → `dotenvx encrypt` のフローを記載しているが、**`pnpm env:update` を使えばより簡単**。
+
+**推奨アクション**: カテゴリ2の冒頭に以下を追加:
+```markdown
+### クイックスタート
+対話式ウィザード `pnpm env:update` で以下の操作を実行できます:
+- 個人トークンを設定
+- チーム共有設定を変更
+- 現在の状態を確認
+
+以下の手順は、ウィザードを使わず手動で実行する場合の詳細フローです。
+```
+
+---
+
+#### 3.2 `pnpm dev:status` / `pnpm dev:logs` コマンド
+
+**現状のSkill記載**: カテゴリ6で `pnpm dev:status` は言及あり
+**実際のpackage.json**:
+- `"dev:status": "tsx scripts/worktree/dev.ts --status"` ✅
+- `"dev:logs": "tail -f log/dev.log"` ✅（Skillに言及なし）
+
+**影響**: カテゴリ1「開発サーバー起動」で、ログ確認手段として `pnpm dev:logs` を案内できる。
+
+**推奨アクション**: カテゴリ1のサブメニューに以下を追加:
+```markdown
+- **ログ確認**: `pnpm dev:logs` 実行
+```
+
+---
+
+#### 3.3 PostgreSQL設定: worktree.config.json
+
+**現状のSkill記載**: なし
+**実際のドキュメント**:
+- local-server-environment-and-worktree.md (L191-L219): `worktree.config.json` でPostgreSQLポート・コンテナ名をカスタマイズ可能 ✅
+
+**影響**: Skillではカスタマイズ手順に言及していないため、ユーザーがデフォルトポート衝突時に対処できない可能性あり。
+
+**推奨アクション**: カテゴリ1「エラー時の対処」に以下を追加:
+```markdown
+| PostgreSQLポート衝突 | `worktree.config.json` の `postgres.port` を変更 |
+```
+
+---
+
+#### 3.4 Serena MCP Serverの存在
+
+**現状のSkill記載**: なし
+**実際のドキュメント**:
+- local-server-environment-and-worktree.md (L631-L696): Serena MCPサーバーは1プロジェクト1インスタンスで共有 ✅
+
+**影響**: Skillではローカル環境セットアップに言及しているが、Serena MCPサーバーの起動・停止については触れていない。
+
+**推奨アクション**: カテゴリ1のヘルスチェックに以下を追加:
+```markdown
+# Serena MCP Server状態
+[ -f .serena-port ] && echo "✅ Serena起動中 (port: $(cat .serena-port | cut -d' ' -f1))" || echo "❌ Serena停止中"
+```
+
+---
+
+#### 3.5 `.env.staging` の存在
+
+**現状のSkill記載**: カテゴリ2で `.env.staging` を対象に含める
+**実際のドキュメント**:
+- environment-variables.md (L42): `.env.staging` は staging ブランチ用として定義済み ✅
+- deployment.md (L520-L524): staging環境の設定一覧に記載 ✅
+
+**影響**: なし。正しく整合している。
+
+---
+
+#### 3.6 Neon: connection_uri API方式の明示
+
+**現状のSkill記載**（カテゴリ4）:
+```bash
+# API（複数ブランチ一括取得時）
+curl -s "https://console.neon.tech/api/v2/projects/$NEON_PROJECT_ID/connection_uri?branch_id=$BRANCH_ID&database_name=neondb&role_name=$ROLE_NAME" \
+  -H "Authorization: Bearer $NEON_API_KEY"
+```
+
+**実際のワークフロー**:
+- `deploy-pr-preview.yml` (L127-L135): `connection_uri` APIでDB URLを取得 ✅（pooled=false/true両対応）
+
+**影響**: Skillの記載は**正確**だが、`pooled` パラメータの説明がない。
+
+**推奨アクション**: カテゴリ4「接続文字列取得」に以下を追記:
+```bash
+# プール接続（pooled=true）
+curl -s "https://console.neon.tech/api/v2/projects/$NEON_PROJECT_ID/connection_uri?branch_id=$BRANCH_ID&pooled=true&database_name=neondb" \
+  -H "Authorization: Bearer $NEON_API_KEY" | jq -r '.uri'
+
+# 直接接続（pooled=false）
+curl -s "https://console.neon.tech/api/v2/projects/$NEON_PROJECT_ID/connection_uri?branch_id=$BRANCH_ID&pooled=false&database_name=neondb" \
+  -H "Authorization: Bearer $NEON_API_KEY" | jq -r '.uri'
+```
+
+---
+
+## 3. 総合評価
+
+### 3.1 適合率
+
+| カテゴリ | 適合状況 | 評価 |
+|---------|---------|------|
+| カテゴリ1: ローカル環境 | 95% | ✅ ほぼ適合（pnpm dev:logs、Serena言及なし） |
+| カテゴリ2: 環境変数管理 | 90% | ⚠️ pnpm env:update言及なし |
+| カテゴリ3: Vercel管理 | 100% | ✅ 完全適合 |
+| カテゴリ4: Neon管理 | 95% | ✅ ほぼ適合（pooled説明なし） |
+| カテゴリ5: GitHub Secrets | 100% | ✅ 完全適合 |
+| カテゴリ6: 環境状態確認 | 95% | ✅ ほぼ適合（Serena言及なし） |
+| カテゴリ7: CI/CD管理 | 100% | ✅ 完全適合 |
+
+**総合適合率**: **96.4%**
+
+---
+
+### 3.2 優先度別推奨修正
+
+#### 優先度: 高（ユーザー体験に直接影響）
+
+1. **カテゴリ2に `pnpm env:update` のクイックスタート案内を追加**
+   - 理由: 既存の対話式ウィザードを案内しないのは不親切
+   - 工数: 5分
+
+2. **カテゴリ1に `pnpm dev:logs` コマンドを追加**
+   - 理由: ログ確認手段の欠落はデバッグ効率に影響
+   - 工数: 3分
+
+#### 優先度: 中（情報の完全性向上）
+
+3. **カテゴリ4のNeon接続文字列取得に `pooled` パラメータを明記**
+   - 理由: ワークフローで使用されている重要な情報
+   - 工数: 5分
+
+4. **カテゴリ1のヘルスチェックに Serena MCP Server状態を追加**
+   - 理由: ローカル環境の完全なヘルスチェックに必要
+   - 工数: 5分
+
+5. **カテゴリ1のエラー対処に `worktree.config.json` 編集案内を追加**
+   - 理由: PostgreSQLポート衝突時の対処手段
+   - 工数: 3分
+
+#### 優先度: 低（現状維持でも問題なし）
+
+6. **Node.js/pnpmの具体的バージョン番号を明記**
+   - 理由: `volta install node@22` で自動的に最新22.xがインストールされるため必須ではない
+   - 工数: 2分
+
+---
+
+## 4. 結論と推奨アクション
+
+### 4.1 現状評価
+
+**infra-maintenance Skillは現状のプロジェクト構成に96.4%適合しており、実用上の問題はない。**
+
+主要な機能（Vercel/Neon/GitHub Secrets管理、CI/CD監視）は全て正確に反映されており、参照ドキュメントも最新の状態と一致している。
+
+### 4.2 推奨修正内容
+
+**修正は任意**だが、以下の5項目を追加することでユーザー体験が向上する:
+
+1. カテゴリ2に `pnpm env:update` のクイックスタート案内
+2. カテゴリ1に `pnpm dev:logs` コマンド
+3. カテゴリ4のNeon接続文字列取得に `pooled` パラメータ説明
+4. カテゴリ1のヘルスチェックに Serena MCP Server状態
+5. カテゴリ1のエラー対処に `worktree.config.json` 編集案内
+
+**総工数**: 約21分
+
+### 4.3 次のステップ
+
+修正を実施する場合は、以下のいずれかを選択してください:
+
+#### オプションA: 即座に修正実施
+- `.claude/skills/einja-infra-maintenance/SKILL.md` を上記5項目で更新
+- コミットメッセージ: `docs: infra-maintenance Skillを最新環境に適合化`
+
+#### オプションB: Issueとして記録
+- 修正内容をIssueに記録し、後日実施
+- ラベル: `enhancement`, `documentation`
+
+#### オプションC: 現状維持
+- 現状のSkillは実用上問題ないため、そのまま運用継続
+
+---
+
+## 5. 補足: 調査で確認した技術スタック
+
+以下は調査過程で確認したプロジェクトの技術スタック一覧です（参考情報）。
+
+| カテゴリ | 技術 | バージョン |
+|---------|------|-----------|
+| **ランタイム** | Node.js | 22.16.0 |
+| | pnpm | 10.14.0 |
+| **フレームワーク** | Next.js | 15.3.9 |
+| | React | 19.0.0 |
+| **データベース** | PostgreSQL | 15-alpine (Docker) |
+| | Prisma Client | 6.10.1 |
+| | Neon | - |
+| **認証** | NextAuth.js | 5.0.0-beta.28 |
+| **UI** | Tailwind CSS | 4.1.10 |
+| | Radix UI | - |
+| **テスト** | Vitest | 3.2.2 |
+| | Playwright | 1.53.0 |
+| **リント/フォーマット** | Biome | 1.9.4 |
+| **ビルド** | Turborepo | 2.5.8 |
+| **インフラ** | Vercel | - |
+| | Neon | - |
+| | GitHub Actions | - |
+| **環境変数** | dotenvx | 1.51.4 |
+| **その他** | Hono | 4.11.3 |
+| | Zod | 3.25.67 / 4.3.5 |
+
+**Drizzle ORM**: 使用されていない（検索結果ゼロ）
+**TypeScript**: v5系
+**Docker**: PostgreSQL 15-alpine
+
+---
+
+**調査完了**: 2026-03-03
+**調査者**: Claude Code（Sonnet 4.5）

package/templates/default/docs/plans/warm-hopping-lighthouse.md

@@ -0,0 +1,199 @@
+# infra-maintenance Skill: ゼロ状態セットアップ対応 改善計画
+
+## Context
+
+infra-maintenance Skill が「一度もインフラ設定がされていないゼロ状態」からのセットアップに対応できるかを Explore + Codex で並行検査した。
+
+**結論: 部分的にしか対応できていない（対応度 60%）**
+
+既存プロジェクトへの参加（`.env.keys` を 1Password から取得済み）には概ね対応しているが、以下の2つのシナリオで Critical なギャップが存在する:
+
+1. **新規プロジェクトの初回構築**: 暗号化ファイルの初回作成フロー、`.env.keys` の生成フローが完全に欠落
+2. **ゼロ状態からの統合フロー**: 複数の❌が検出された場合に何から始めるべきかの案内がない
+
+> **注意**: `setup-dev.ts` 自体は `.env.keys` 不在時のフォールバック（`.env.example` → `.env`）を持っており、ローカル開発は最低限動作する。しかし SKILL.md はこの実態を反映していない。
+
+---
+
+## 検出された問題（優先度順）
+
+### Critical（初回ユーザーがブロックされる）
+
+| # | 問題 | 影響 | 対象 |
+|---|------|------|------|
+| C-1 | Phase 1/2: 複数❌検出時の統合フロー（ゼロ状態判定）がない | どのカテゴリから始めるべきか不明 | SKILL.md Phase 2 |
+| C-2 | カテゴリ2: 暗号化ファイルの初回作成フローがない | 新規プロジェクトで環境変数を設定できない | SKILL.md カテゴリ2 |
+
+### High（手順が不完全）
+
+| # | 問題 | 影響 | 対象 |
+|---|------|------|------|
+| H-1 | カテゴリ1: `pnpm dev:setup` が何を実行するかの説明がない | ユーザーが何が起こるか理解できない | SKILL.md カテゴリ1 |
+| H-2 | カテゴリ3: Vercelプロジェクト未作成時の手順がない（`vercel link` のみ） | プロジェクト新規作成が案内されない | SKILL.md カテゴリ3 |
+| H-3 | カテゴリ1: Docker未インストール時の案内がない | PostgreSQL起動前にDockerが必要 | SKILL.md カテゴリ1 |
+
+### Medium（改善余地）
+
+| # | 問題 | 影響 | 対象 |
+|---|------|------|------|
+| M-1 | カテゴリ4: `.env.preview` が未存在時の NEON_PROJECT_ID 設定が簡略すぎ | `pnpm env:update` への誘導がない | SKILL.md カテゴリ4 |
+| M-2 | deployment-setup.md Section 0 との順序不整合 | どちらを信頼すべきか混乱 | SKILL.md/deployment-setup.md |
+
+---
+
+## 修正計画
+
+### 修正ファイル: `.claude/skills/einja-infra-maintenance/SKILL.md`
+
+#### 修正1: Phase 2 にゼロ状態判定ロジックを追加（C-1）
+
+**箇所**: Phase 2「意図判定とメインメニュー」セクション（74行目付近）の「意図が明確な場合」の前に追加
+
+**追加内容**:
+```markdown
+### ゼロ状態の検出と統合初期構築フロー
+
+Phase 1 で以下の条件が同時に成立した場合、「ゼロ状態」と判定し、統合初期構築フローを提案する:
+
+**判定条件**: `.env.keys`不在 AND (`.env.personal`不在 OR vercel CLI未インストール OR neonctl未インストール)
+
+**提案**: AskUserQuestion で以下を選択させる:
+
+| 選択肢 | 説明 |
+|--------|------|
+| ローカル開発のみ（推奨） | 最速で開発環境を起動: カテゴリ1 → 2 |
+| 本番デプロイまで | CI/CD含む完全セットアップ: カテゴリ1 → 4 → 3 → 5 → 2 |
+| いいえ（個別選択） | 通常のメインメニューを表示 |
+
+> **参照**: 完全セットアップの詳細手順は `docs/einja/instructions/deployment-setup.md` セクション0「ゼロからの統合初期構築フロー」を参照
+```
+
+#### 修正2: カテゴリ1 のセットアップ詳細を拡充（H-1, H-3）
+
+**箇所**: カテゴリ1「エラー時の対処」テーブル（134-140行目）
+
+**変更**: Docker未インストール時の案内を追加（`.env.keys` 不在の対処は現状維持）
+
+追加行:
+```
+| Docker未インストール | `docker --version` で確認 → 未インストール時は [OrbStack](https://orbstack.dev/) のインストールを案内 |
+```
+
+**箇所**: カテゴリ1「初回セットアップ」（128-131行目）
+
+現在:
+```
+#### 初回セットアップ
+1. `pnpm install` で依存関係インストール
+2. `pnpm dev:setup` で環境セットアップ
+3. エラー時: エラー内容を分析し、対話的にトラブルシュート
+```
+
+修正後:
+```
+#### 初回セットアップ
+1. `pnpm install` で依存関係インストール
+2. `pnpm dev:setup` で環境セットアップ（以下を自動実行）:
+   - Volta / direnv / dotenvx の自動インストール（macOS）
+   - `.env.keys` が存在する場合: `.env.local` を復号して `.env` を生成
+   - `.env.keys` が不在の場合: worktree親からのコピーを試行 → 失敗時は `.env.example` からフォールバック
+   - GITHUB_TOKEN の対話式設定
+   - PostgreSQL 起動（Docker）+ Prisma セットアップ
+3. エラー時: エラー内容を分析し、対話的にトラブルシュート
+```
+
+#### 修正3: カテゴリ2 に「初回環境ファイル作成」サブメニューを追加（C-2）
+
+**箇所**: カテゴリ2 サブメニュー（149行目付近）に追加
+
+**追加内容**:
+```markdown
+- **初回環境ファイル作成**: 新規プロジェクト用。`.env.local`等を新規作成し暗号化（`.env.keys` が自動生成される）
+```
+
+カテゴリ2 の実行手順セクションに新セクション追加:
+```markdown
+#### 初回環境ファイル作成（新規プロジェクト用）
+1. AskUserQuestionで作成する環境を選択（.env.local / .env.develop / .env.staging / .env.production / .env.preview）
+2. `.env.example` をベースにファイルを作成
+3. AskUserQuestionで必須環境変数の値を入力（DATABASE_URL, AUTH_SECRET 等）
+4. `dotenvx encrypt -f <file>` で暗号化（`.env.keys` に秘密鍵が自動追記される）
+5. AskUserQuestion: 「`.env.keys` を 1Password に保存しましたか？」（保管先URL案内）
+6. 他環境のファイルも作成が必要か確認 → 必要なら手順1に戻る
+7. GitHub Secrets への登録を促す（カテゴリ5へ遷移案内）
+
+> **注意**: `.env.keys` は全環境の秘密鍵を含む重要ファイル。必ず 1Password 等で安全に共有すること。
+```
+
+#### 修正4: カテゴリ3 にプロジェクト新規作成フローを追加（H-2）
+
+**箇所**: カテゴリ3 サブメニュー（197行目付近）
+
+現在:
+```
+- **初期設定**: プロジェクト作成・リンク・Root Directory設定
+```
+
+修正後:
+```
+- **新規プロジェクト作成**: Vercelプロジェクトを新規作成しリンク
+- **既存プロジェクト接続**: 既存プロジェクトにリンク・Root Directory設定
+```
+
+実行手順の「初期設定」を「新規プロジェクト作成」と「既存プロジェクト接続」に分割:
+```markdown
+#### 新規プロジェクト作成
+1. VERCEL_TOKEN確認 → 未設定時はURL案内 + `.env.personal`保存
+2. AskUserQuestionでアプリ選択（web / admin）
+3. `vercel --confirm` で新規プロジェクト作成（対話式）
+4. Root Directory設定（API経由）
+5. プロジェクトID取得・表示
+6. VERCEL_ORG_ID / VERCEL_PROJECT_ID を `.env.personal` に記録
+
+> **詳細手順**: `docs/einja/instructions/vercel-cli-reference.md` を参照
+
+#### 既存プロジェクト接続
+（現在の「初期設定」の内容をそのまま維持）
+```
+
+#### 修正5: カテゴリ4 の `.env.preview` 設定を詳細化（M-1）
+
+**箇所**: カテゴリ4 初期設定の手順3（258行目）
+
+現在:
+```
+3. NEON_PROJECT_IDを`.env.preview`に設定 → dotenvx暗号化
+```
+
+修正後:
+```
+3. NEON_PROJECT_IDを`.env.preview`に設定:
+   - `.env.preview`が既存の場合: `pnpm env:update` で対話式に設定
+   - `.env.preview`が未存在の場合: カテゴリ2「初回環境ファイル作成」で先に作成
+```
+
+---
+
+## 修正対象ファイル
+
+| ファイル | 修正内容 |
+|---------|---------|
+| `.claude/skills/einja-infra-maintenance/SKILL.md` | 修正1〜5の全て |
+
+> **注**: `deployment-setup.md` や `environment-setup.md` の修正は今回のスコープ外。SKILL.md から適切に参照・誘導することで対応する。
+
+---
+
+## 検証方法
+
+1. `pnpm prepush` で lint/typecheck/test が通ることを確認
+2. SKILL.md を Read して全修正がディスク上に反映されていることを確認
+3. 以下のシナリオで SKILL.md のフローを追跡し、ブロックが発生しないことを確認:
+   - シナリオA: `.env.keys` なし + 単一worktree → 1Password案内 → カテゴリ1完了
+   - シナリオB: 完全ゼロ状態 → ゼロ状態判定 → 「ローカル開発のみ」選択 → カテゴリ1→2
+   - シナリオC: 完全ゼロ状態 → 「本番デプロイまで」選択 → カテゴリ1→4→3→5→2
+
+## 調査レポート
+
+- Explore: `docs/plans/warm-hopping-lighthouse-agent-a30aa4f.md`
+- Codex: `docs/plans/warm-hopping-lighthouse-agent-a57a278.md`