@einja/dev-cli 0.1.39 → 0.1.41

package/presets/default/docs/einja/steering/development-workflow.md

@@ -12,9 +12,9 @@
     ↓
 仕様書レビュー（Discord + Spec PR）
     ↓
-タスク実行（pnpm task:loop）
+タスク実行（/einja:issue-exec or /einja:task-exec）
     ↓
-自己レビュー → PR作成（Vibe-Kanban）
+自己レビュー → PR作成（自動）
     ↓
 コードレビュー（GitHub PR）
     ↓
@@ -57,32 +57,23 @@
                             Spec PRをマージ
                                     ↓
 ┌─────────────────────────────────────────────────────────────────────────────┐
-│ Phase B: タスク実行（Vibe-Kanban + task:loop）                                │
+│ Phase B: タスク実行（/einja:issue-exec or /einja:task-exec）                  │
 ├─────────────────────────────────────────────────────────────────────────────┤
 │                                                                              │
-│  事前準備: npx vibe-kanban（別ターミナルで起動）                              │
-│                                                                              │
-│  pnpm task:loop <issue-number>                                              │
+│  /einja:issue-exec #<issue-number>                                          │
 │      │                                                                       │
-│      ├── 初期化: Issue取得、ブランチ作成、Vibe-Kanban接続                     │
-│      │      ├── Phase毎に親Issue作成（MCP create_issue）                     │
+│      ├── Manager: Issue パース、Phase 毎に Director を tmux で起動            │
 │      │                                                                       │
-│      └── ループ開始 ─────────────────────────────────────────┐               │
-│           │                                                   │               │
-│           ▼                                                   │               │
-│      ┌─────────────────────────────────────────────────────┐ │               │
-│      │ 着手可能なタスクグループを選定（依存関係考慮）        │ │               │
-│      └─────────────────────────────────────────────────────┘ │               │
+│      └── Director（Phase毎）────────────────────────────────┐               │
 │           │                                                   │               │
 │           ▼                                                   │               │
 │      ┌─────────────────────────────────────────────────────┐ │               │
-│      │ サブIssue作成（親Issue配下） → start_workspace_session│ │               │
-│      │ （Claude Codeが自動起動されて実装開始）              │ │               │
+│      │ タスクグループを依存順に Worker を起動               │ │               │
 │      └─────────────────────────────────────────────────────┘ │               │
 │           │                                                   │               │
 │           ▼                                                   │               │
 │      ┌─────────────────────────────────────────────────────┐ │               │
-│      │ Claude Code（自動実行）                             │ │               │
+│      │ Worker（/einja:task-exec を実行）                   │ │               │
 │      │                                                      │ │               │
 │      │  task-executer: 実装                                 │ │               │
 │      │       ↓                                              │ │               │
@@ -90,37 +81,25 @@
 │      │       ↓                                              │ │               │
 │      │  task-qa: 動作確認（Playwright/curl）（自動）        │←┘               │
 │      │       ↓ 全テスト合格                                 │                 │
-│      │  ステータス → In Review                              │                 │
+│      │  commit & push → PR 自動作成                         │                 │
 │      └─────────────────────────────────────────────────────┘                 │
 │           │                                                                   │
 │           ▼                                                                   │
-│      【人間がVibe-Kanbanで確認】                                              │
-│      ├── 自己レビュー（実装内容確認）                                         │
-│      └── OKなら「Create PR」ボタンクリック                                    │
-│           │                                                                   │
-│           ▼                                                                   │
 │      【GitHubでPRレビュー】                                                   │
-│      ├── 担当者レビュー（動作確認 + コード確認）                               │
-│      └── 他エンジニアレビュー                                                 │
-│           │                                                                   │
-│           ▼ 承認                                                             │
-│      GitHub側でPRマージ（⚠️必ずGitHub側で操作）                               │
-│           │                                                                   │
-│           ▼                                                                   │
-│      Vibe-Kanbanがマージ検知 → タスク自動Done                                 │
+│      ├── PRの内容を確認                                                       │
+│      └── マージモードに応じてマージ（manual / task-group-auto / auto）         │
 │           │                                                                   │
 │           ▼                                                                   │
-│      task:loopがDone検知 → GitHub Issueチェックボックス更新                   │
+│      Director: PR マージ検知 → GitHub Issue チェックボックス更新              │
 │           │                                                                   │
-│      Phase全サブIssue完了？                                                   │
-│      ├─ Yes → 親Issue Workspace作成 → PR作成・マージ                         │
-│      │        → 親Issue自動Done                                               │
-│      └─ No  → スキップ                                                       │
+│      Phase全タスク完了？                                                      │
+│      ├─ Yes → Phase PR 作成（Phase → Issue ブランチ）                        │
+│      │        → マージモードに応じた処理                                      │
+│      └─ No  → 依存解除された次タスクの Worker を起動                          │
 │           │                                                                   │
 │           └──────────────────────────────────────────────────┘               │
-│                        次のタスクグループを自動開始                            │
 │                                                                              │
-│      全タスクグループ完了 → Issue Close                                       │
+│      全 Phase 完了 → 最終 PR 作成（Issue → base ブランチ）                    │
 │                                                                              │
 └─────────────────────────────────────────────────────────────────────────────┘
 ```
@@ -174,42 +153,35 @@ Spec PR                # 仕様書レビュー用
 ### コマンド
 
 ```bash
-# 事前準備: Vibe-Kanbanを起動（別ターミナル）
-npx vibe-kanban
-
-# タスクループ開始
-pnpm task:loop <issue-number>
-```
+# Issue全体の並列実行（推奨：複数Phase・複数タスクグループの場合）
+/einja:issue-exec #123
+/einja:issue-exec #123 --merge-mode task-group-auto   # タスクPR自動マージ
+/einja:issue-exec #123 --merge-mode auto               # 全自動
+/einja:issue-exec #123 --max-phase 2                   # Phase 2 まで
+/einja:issue-exec #123 --base develop                  # ベースブランチ指定
 
-**例**:
-```bash
-pnpm task:loop 123                        # Issue #123 の全タスクを実行
-pnpm task:loop 123 --max-group 4          # Phase 4 まで実行
-pnpm task:loop 123 --max-group 4.2        # タスクグループ 4.2 まで実行
-pnpm task:loop 123 --branch develop       # develop ブランチベースで実行
+# 単一タスクグループ実行（品質重視・複雑な実装向け）
+/einja:task-exec #123 1.1                               # Issue #123 のタスクグループ 1.1 を実行
 ```
 
-### 実行後の流れ
+### 実行後の流れ（/einja:issue-exec）
 
-実行後、specで作成されたタスクが着手可能なものから自動で実行開始されます。
+`/einja:issue-exec` は Manager → Director → Worker の3階層でタスクを並列実行します。
 
-Phase毎に親Issueが自動作成され、タスクグループはサブIssueとして管理されます。
+1. **Manager** が Issue をパースし、Phase 毎に Director を tmux で起動
+2. **Director** が Phase 内のタスクグループを依存順に Worker を起動
+3. **Worker** が `/einja:task-exec` を実行（executer → reviewer → qa → commit）
+4. Worker 完了後、PR が自動作成される
+5. マージモードに応じて PR がマージされ、次のタスクが自動開始
 
-1. **Vibe-Kanbanの画面を眺める** - タスクの進捗を確認
-2. **In Reviewになったら自己レビュー** - 実装内容を確認
-3. **OKなら「Create PR」ボタンをクリック** - PRが自動作成される
-4. **GitHubでチームレビュー** - コード確認・承認
-5. **GitHub側でPRをマージ** - ⚠️ 必ずGitHub側で操作
-6. **次のタスクが自動開始** - マージ検知で自動的に次へ（少しラグあり）
+ユーザーは `tmux attach -t einja-{issue番号}` で全プロセスを監視できます。
 
-### Vibe-Kanban画面での操作
+### `/einja:issue-exec` と `/einja:task-exec` の使い分け
 
-| 操作 | タイミング | 説明 |
-|------|-----------|------|
-| **タスク進捗確認** | 随時 | Todo → In Progress → In Review → Done の流れを確認 |
-| **Create PR** | In Review 時 | ボタンをクリックして PR を自動作成 |
-| **レビュー** | PR 作成後 | GitHub で PR の内容を確認 |
-| **マージ** | レビュー完了後 | GitHub で PR をマージ（⚠️ 必ず GitHub 側で操作） |
+| コマンド | 用途 | 対象 | 推奨シーン |
+|---------|------|------|----------|
+| **`/einja:issue-exec`** | Issue全体の並列実行 | 複数Phase・複数タスクグループ | 大規模機能実装 |
+| **`/einja:task-exec`** | 単一タスクグループの確実な完了 | 1つのタスクグループ | 複雑な実装、品質重視 |
 
 ### サブエージェントの役割
 
@@ -224,32 +196,27 @@ Phase毎に親Issueが自動作成され、タスクグループはサブIssue
 `task-reviewer`または`task-qa`で問題が発見された場合、自動的に`task-executer`に戻って修正が行われます。
 
 ```
-task-executer → task-reviewer → task-qa → In Review
+task-executer → task-reviewer → task-qa → PR作成
       ↑              │              │
       └──────────────┴──────────────┘
            問題発見時は自動ループ
 ```
 
-### マージ後の自動処理
+### マージ後の自動処理（/einja:issue-exec 使用時）
 
 ```
-┌─────────────────────────────────────────────────────────────┐
-│  PR マージ（GitHub側で操作）                                │
-│      ↓                                                      │
-│  Vibe-Kanban: タスク → Done（自動検知）                    │
-│      ↓                                                      │
-│  task:loop: Done 検知（15秒ポーリング）                     │
-│      ↓                                                      │
-│  GitHub Issue: チェックボックス更新（自動）                 │
-│      ↓                                                      │
-│  Phase 全サブIssue完了？                                    │
-│      ├─ Yes → 親Issue Workspace作成                         │
-│      │        → Phase→Issue PR作成・マージ                  │
-│      │        → 親Issue自動Done（タイムアウト2分）           │
-│      └─ No  → スキップ                                      │
-│      ↓                                                      │
-│  次のタスクが自動開始                                       │
-└─────────────────────────────────────────────────────────────┘
+Worker: task-exec 完了 → commit & push → PR 作成
+      ↓
+Director: PR マージ検知
+      ↓
+GitHub Issue チェックボックス更新
+      ↓
+Phase 全タスク完了？
+├─ Yes → Phase PR 作成（Phase → Issue ブランチ）
+│        → マージモードに応じた処理
+└─ No  → 依存解除された次タスクの Worker を起動
+      ↓
+全 Phase 完了 → 最終 PR 作成（Issue → base ブランチ）
 ```
 
 ---
@@ -261,7 +228,7 @@ task-executer → task-reviewer → task-qa → In Review
 | PRの種類    | 作成タイミング       | 内容                       | レビュー観点                                   |
 | ----------- | -------------------- | -------------------------- | ---------------------------------------------- |
 | **Spec PR** | `/einja:spec-create`完了時 | requirements.md, design.md | 要件の妥当性、設計の適切さ、スコープの確認     |
-| **実装PR**  | タスクグループ完了時（Vibe-KanbanでCreate PR） | ソースコード、テスト       | コード品質、設計書との整合性、テストカバレッジ |
+| **実装PR**  | タスクグループ完了時（Worker が自動作成） | ソースコード、テスト       | コード品質、設計書との整合性、テストカバレッジ |
 
 ### なぜ2段階でPRを作成するのか
 
@@ -283,9 +250,9 @@ task-executer → task-reviewer → task-qa → In Review
 
 ### タスク実行フェーズ
 
-- **自己レビュー**: Vibe-KanbanでIn Reviewになったタスクの実装内容確認
-- **Create PRクリック**: 自己レビューOKならPR作成
-- **実装PRレビュー**: 担当者レビュー → 他エンジニアレビュー → 承認 → マージ
+- **PRレビュー**: Worker が自動作成した PR の内容を確認
+- **PRマージ**: マージモードが manual の場合、GitHub で PR をマージ
+- **質問回答**: Manager から AskUserQuestion でエスカレーションされた質問に回答
 
 ### Claudeのセルフチェックについて
 
@@ -294,7 +261,7 @@ task-executer → task-reviewer → task-qa → In Review
 | 従来（人間が実装） | 現在（Claudeが実装） |
 |------------------|-------------------|
 | 実装者がセルフチェック | `task-reviewer` + `task-qa` がセルフチェック |
-| セルフチェック後にPR作成 | セルフチェック後にIn Review → 人間がCreate PR |
+| セルフチェック後にPR作成 | セルフチェック後に自動でPR作成 |
 | 他のエンジニアがPRレビュー | 人間（担当者 + 他エンジニア）がPRレビュー |
 
 ---
@@ -317,37 +284,27 @@ task-executer → task-reviewer → task-qa → In Review
 ### タスク実行
 
 ```bash
-# 自動ループ実行（推奨）
-pnpm task:loop <issue-number>
+# Issue全体の並列実行（推奨）
+/einja:issue-exec #<issue_number>
 
 # オプション指定
-pnpm task:loop <issue-number> --max-group <number> --branch <branch>
-
-# 例
-pnpm task:loop 123                        # Issue #123 の全タスクを実行
-pnpm task:loop 123 --max-group 4          # Phase 4 まで実行
-pnpm task:loop 123 --max-group 4.2        # タスクグループ 4.2 まで実行
+/einja:issue-exec #<issue_number> --merge-mode auto --max-phase 2
 
 # 単一タスクグループ実行（品質重視・複雑な実装向け）
 /einja:task-exec #<issue_number> <task_group_number>
 
 # 例
-/einja:task-exec #123 1.1                 # Issue #123 のタスクグループ 1.1 を実行
+/einja:issue-exec #123                                   # Issue #123 の全タスクを並列実行
+/einja:issue-exec #123 --merge-mode task-group-auto      # タスクPR自動マージ
+/einja:task-exec #123 1.1                                # タスクグループ 1.1 を単発実行
 ```
 
-### `/einja:task-exec` と `pnpm task:loop` の使い分け
-
-| コマンド | 用途 | 品質保証 | 推奨シーン |
-|---------|------|---------|----------|
-| **`/einja:task-exec`** | 重要タスクの確実な完了 | ✅ 合格まで自動ループ | 複雑な実装、品質重視 |
-| **`pnpm task:loop`** | 大量タスクの自動消化 | 並列実行・監視 | 定型作業、並行開発 |
-
 ---
 
 ## 関連ドキュメント
 
 - [タスク管理ガイドライン](task-management.md) - タスク階層、粒度基準、GitHub Issue管理
-- [task:loop詳細ガイド](../instructions/task-vibe-kanban-loop.md) - task:loopの詳細な使い方
+- [Issue実行ワークフロー](../instructions/issue-exec-workflow.md) - Issue実行の詳細な使い方
 - [ブランチ戦略](branch-strategy.md) - ブランチ運用ルール
 - [コードレビューガイドライン](development/review-guidelines.md) - 品質基準とチェックリスト
 
@@ -373,15 +330,10 @@ pnpm task:loop 123 --max-group 4.2        # タスクグループ 4.2 まで実
 
 ### Q: PRのマージはどこで行いますか？
 
-**A:** 必ず**GitHub側**でマージしてください。Vibe-Kanbanがマージを検知して自動的にタスクをDoneに変更し、task:loopが次のタスクを開始します。
-
-### Q: タスクがIn Reviewのまま進まない場合は？
-
-**A:**
-1. Vibe-Kanbanで「Create PR」をクリックしてPRを作成
-2. GitHubでPRをレビュー・マージ
-
-PRがマージされるとタスクは自動的にDoneになります。
+**A:** マージモードによって異なります：
+- **manual**（デフォルト）: GitHub側で手動マージしてください。Director がマージを検知して次のタスクを開始します。
+- **task-group-auto**: タスクグループPRは自動マージされます。Phase PRは手動マージです。
+- **auto**: タスクPR・Phase PRが自動マージされます。最終PR（issue→base）は常に手動マージです。
 
 ---
 
@@ -444,11 +396,6 @@ PRがマージされるとタスクは自動的にDoneになります。
 ```
 <!-- @einja:managed:end -->
 
----
-
-<!-- @einja:seed:start id="development-workflow-project" -->
-## プロジェクト固有の設定
-
-<!-- このセクションはプロジェクト固有の内容を追記する場所です -->
-<!-- einja syncで上書きされません -->
-<!-- @einja:seed:end -->
+<!-- @einja:project-private:start id="development-workflow-project" -->
+<!-- プロジェクト固有の情報を記入 -->
+<!-- @einja:project-private:end -->

package/presets/default/docs/einja/steering/infrastructure/deployment.md

@@ -155,7 +155,7 @@ graph LR
 
 | ワークフロー | ファイル | トリガー | 用途 |
 |------------|---------|---------|------|
-| **Deploy Stable** | `deploy-stable-branches.yml` | push to main/develop/staging | CI → 本番・開発・ステージング環境デプロイ |
+| **Deploy Stable** | `deploy-stable-branches.yml` | push to main/develop/staging | CI → 動的マトリクス → 変更アプリのみデプロイ（`--env`実行時注入） |
 | **PR Preview** | `deploy-pr-preview.yml` | PR opened/sync/closed | CI → Neonブランチ作成 → プレビューデプロイ |
 | **PR Close Cleanup** | `cleanup-pr-preview-on-close.yml` | PR closed | Neonブランチの即座削除（PR close時） |
 | **Cleanup DB** | `cleanup-pr-preview-db.yml` | 毎日00:00 UTC / 手動 | 孤立したNeonブランチ削除 |
@@ -185,8 +185,7 @@ flowchart TB
     end
 
     subgraph "migrate/action.yml"
-        M1[setup action 呼び出し] --> M2[pnpm generate]
-        M2 --> M3[db:migrate:deploy]
+        M1[setup action 呼び出し] --> M3[db:migrate:deploy]
         M3 --> M4{run-seed?}
         M4 -->|true| M5[db:seed]
         M4 -->|false| M6[完了]
@@ -201,7 +200,7 @@ flowchart TB
 |--------|---------|------|-----------|
 | **Setup** | `actions/setup/action.yml` | pnpm + Node.js + install | ci action, migrate action, cleanup |
 | **CI** | `actions/ci/action.yml` | setup → generate → [migrate] → typecheck → lint → test | deploy-stable-branches, deploy-pr-preview |
-| **Migrate** | `actions/migrate/action.yml` | setup → generate → migrate → seed (optional) | deploy-stable-branches |
+| **Migrate** | `actions/migrate/action.yml` | setup → migrate → seed (optional) | deploy-stable-branches |
 | **Neon Export Env** | `actions/neon-export-env/action.yml` | .env.previewからNeon環境変数をエクスポート | deploy-pr-preview, cleanup-pr-preview-on-close |
 
 ### 実行マトリクス
@@ -258,9 +257,8 @@ sequenceDiagram
     rect rgb(240, 255, 240)
         Note over Actions,Vercel: Vercel デプロイ
         Actions->>Vercel: vercel pull
-        Actions->>Vercel: 環境変数同期 (encrypted-only)
         Actions->>Vercel: vercel build (DATABASE_URL=pooled)
-        Actions->>Vercel: vercel deploy --prebuilt
+        Actions->>Vercel: vercel deploy --prebuilt --env（全encrypted変数を実行時注入）
         Vercel-->>Actions: Preview URL
     end
 
@@ -308,10 +306,12 @@ sequenceDiagram
     rect rgb(240, 255, 240)
         Note over Actions,Vercel: Vercel デプロイ
         Actions->>Vercel: vercel pull
-        Actions->>Vercel: 環境変数同期 (encrypted-only)
-        Actions->>Vercel: vercel pull (Re-pull: 同期後の最新化)
+        alt mainブランチのみ
+            Actions->>Vercel: 環境変数同期 (encrypted-only, vercel env add)
+            Actions->>Vercel: vercel pull (Re-pull: 同期後の最新化)
+        end
         Actions->>Vercel: vercel build [--prod]
-        Actions->>Vercel: vercel deploy --prebuilt [--prod]
+        Actions->>Vercel: vercel deploy --prebuilt --env [--prod]（全encrypted変数を実行時注入）
         Vercel-->>Actions: Deploy URL
     end
 
@@ -383,15 +383,15 @@ sequenceDiagram
 ```mermaid
 flowchart TD
     A[git push main] --> B[deploy-stable-branches.yml]
-    B --> C[CI Checks]
-    C --> D{成功?}
+    B --> C[CI Checks + 変更検知]
+    C --> D{成功 & 変更あり?}
     D -->|Yes| E[dotenvx復号化]
-    D -->|No| X[失敗通知]
+    D -->|No| X[スキップ]
     E --> F[Vercel Pull]
-    F --> G[環境変数同期]
+    F --> G[環境変数同期 vercel env add]
     G --> H[DB Migrate]
     H --> I[Vercel Build]
-    I --> J[Vercel Deploy --prod]
+    I --> J[Vercel Deploy --prod --env]
     J --> K[完了]
 
     style A fill:#4CAF50
@@ -413,19 +413,18 @@ flowchart TD
 ```mermaid
 flowchart TD
     A[git push develop] --> B[deploy-stable-branches.yml]
-    B --> C[CI Checks]
-    C --> D{成功?}
+    B --> C[CI Checks + 変更検知]
+    C --> D{成功 & 変更あり?}
     D -->|Yes| E[dotenvx復号化]
-    D -->|No| X[失敗通知]
+    D -->|No| X[スキップ]
     E --> F[Vercel Pull]
-    F --> G[環境変数同期]
-    G --> H[Vercel Build]
-    H --> I[Vercel Deploy]
-    I --> J[Alias設定]
-    J --> K[完了]
+    F --> G[Vercel Build]
+    G --> H[Vercel Deploy --env]
+    H --> I[Alias設定]
+    I --> J[完了]
 
     style A fill:#2196F3
-    style K fill:#2196F3
+    style J fill:#2196F3
 ```
 
 **設定**:
@@ -434,7 +433,7 @@ flowchart TD
 - 復号鍵: `DOTENV_PRIVATE_KEY_DEVELOP`
 - DBマイグレーション: ❌（PR PreviewのNeonブランチで自動同期）
 - DBシード: ❌
-- Alias: `secrets.VERCEL_DEV_DOMAIN`
+- Alias: `.env.develop` 内の `VERCEL_ALIAS_DOMAIN_WEB` / `VERCEL_ALIAS_DOMAIN_ADMIN`（dotenvx復号で取得）
 
 ---
 
@@ -443,20 +442,19 @@ flowchart TD
 ```mermaid
 flowchart TD
     A[git push staging] --> B[deploy-stable-branches.yml]
-    B --> C[CI Checks]
-    C --> D{成功?}
+    B --> C[CI Checks + 変更検知]
+    C --> D{成功 & 変更あり?}
     D -->|Yes| E[dotenvx復号化]
-    D -->|No| X[失敗通知]
+    D -->|No| X[スキップ]
     E --> F[Vercel Pull]
-    F --> G[環境変数同期]
-    G --> H[DB Migrate]
-    H --> I[Vercel Build]
-    I --> J[Vercel Deploy]
-    J --> K[Alias設定]
-    K --> L[完了]
+    F --> G[DB Migrate]
+    G --> H[Vercel Build]
+    H --> I[Vercel Deploy --env]
+    I --> J[Alias設定]
+    J --> K[完了]
 
     style A fill:#FF9800
-    style L fill:#FF9800
+    style K fill:#FF9800
 ```
 
 **設定**:
@@ -465,7 +463,7 @@ flowchart TD
 - 復号鍵: `DOTENV_PRIVATE_KEY_STAGING`
 - DBマイグレーション: ✅
 - DBシード: ❌（既存データ保持）
-- Alias: `secrets.VERCEL_STG_DOMAIN`
+- Alias: `.env.staging` 内の `VERCEL_ALIAS_DOMAIN_WEB` / `VERCEL_ALIAS_DOMAIN_ADMIN`（dotenvx復号で取得）
 
 ---
 
@@ -506,12 +504,12 @@ flowchart TD
 
 > **⚠️ 同時PR運用時の注意**
 >
-> テンプレートでは`vercel deploy --env DATABASE_URL=...`でデプロイ単位で
-> DATABASE_URLを注入しています。これにより、同時に複数のPRがプレビュー
-> デプロイされても、それぞれのPRが固有のNeonブランチDBを参照します。
+> テンプレートでは`vercel deploy --env KEY=VALUE`でデプロイ単位で
+> 全encrypted環境変数（DATABASE_URL含む）を実行時注入しています。
+> これにより、同時に複数のPRがプレビューデプロイされても、
+> それぞれのPRが固有のNeonブランチDBを参照し、環境変数の競合が発生しません。
 >
-> もし`vercel env add DATABASE_URL`方式を使用すると、Vercel Projectの
-> preview環境変数が上書きされ、同時PRで競合するリスクがあります。
+> PR環境では`vercel env add`は使用しません（並行PR間の競合を防ぐため）。
 
 ---
 
@@ -520,20 +518,21 @@ flowchart TD
 | 環境 | ブランチ | Vercel環境 | DBマイグ | シード | Alias | 暗号化ファイル | 復号鍵 |
 |------|---------|-----------|:-------:|:-----:|:-----:|--------------|--------|
 | Production | main | production | ✅ | ❌ | ❌ | `.env.production` | `DOTENV_PRIVATE_KEY_PRODUCTION` |
-| Develop | develop | preview | ❌ | ❌ | ✅ | `.env.develop` | `DOTENV_PRIVATE_KEY_DEVELOP` |
-| Staging | staging | preview | ✅ | ❌ | ✅ | `.env.staging` | `DOTENV_PRIVATE_KEY_STAGING` |
+| Develop | develop | preview | ❌ | ❌ | ✅ `VERCEL_ALIAS_DOMAIN_*` | `.env.develop` | `DOTENV_PRIVATE_KEY_DEVELOP` |
+| Staging | staging | preview | ✅ | ❌ | ✅ `VERCEL_ALIAS_DOMAIN_*` | `.env.staging` | `DOTENV_PRIVATE_KEY_STAGING` |
 | PR Preview | feature/* | preview | ✅ | ✅ | ❌ | `.env.preview` | `DOTENV_PRIVATE_KEY_PREVIEW` |
 
 ### Vercel環境変数の自動同期
 
 ワークフローは **encrypted-only方式** で同期対象を制御:
 
-| ワークフロー | 同期対象 | 除外 | 説明 |
-|------------|---------|------|------|
-| PR Preview | `.env.preview` 内の `encrypted:` キー | `NEON_*`, `DATABASE_*` | dotenvxで管理しているもの = Vercelに同期すべきもの |
-| Stable Branches | `.env.{env}` 内の `encrypted:` キー | なし | dotenvxで管理している全キーを同期 |
+| ワークフロー | 方式 | 同期対象 | 除外 | 説明 |
+|------------|------|---------|------|------|
+| PR Preview | `--env`実行時注入 | `.env.preview` 内の `encrypted:` キー | `NEON_*`, `DOTENV_PUBLIC_KEY_*` | `vercel env add`は使用しない（並行PR競合防止） |
+| Stable (main) | `vercel env add` + `--env`実行時注入 | `.env.production` 内の `encrypted:` キー | `NEON_*` | mainのみVercel環境変数ストアに同期 |
+| Stable (develop/staging) | `--env`実行時注入 | `.env.{env}` 内の `encrypted:` キー | `NEON_*`, `VERCEL_ALIAS_DOMAIN_*`, `DOTENV_PUBLIC_KEY_*` | `vercel env add`は使用しない |
 
-**設計意図**: dotenvxの暗号化ファイル内の `encrypted:` を含む行のキー名のみを対象とし、「dotenvxで管理 = Vercelに同期」の意図を明確にする。ブラックリスト方式（全env走査）ではシステム変数混入や新変数追加時の漏れリスクがあるため廃止。
+**設計意図**: `vercel env add`によるVercel環境変数ストアへの書き込みはmainブランチのみに限定。develop/staging/PRは`vercel deploy --env`による実行時注入で環境変数を渡し、並行デプロイ間の競合を防止する。
 
 ---
 
@@ -688,11 +687,6 @@ sequenceDiagram
 - [Vercel CLI/APIリファレンス](../../instructions/vercel-cli-reference.md)
 <!-- @einja:managed:end -->
 
----
-
-<!-- @einja:seed:start id="deployment-project" -->
-## プロジェクト固有の設定
-
-<!-- このセクションはプロジェクト固有の内容を追記する場所です -->
-<!-- einja syncで上書きされません -->
-<!-- @einja:seed:end -->
+<!-- @einja:project-private:start id="deployment-project" -->
+<!-- プロジェクト固有の情報を記入 -->
+<!-- @einja:project-private:end -->

package/presets/default/docs/einja/steering/infrastructure/environment-variables.md

@@ -279,6 +279,7 @@ dotenvx採用により、GitHub Secretsは**環境ごとに1つの秘密鍵の
 
 | Secret名 | 用途 |
 |---------|------|
+| `DOTENV_PRIVATE_KEY_DEVELOP` | dev検証環境の復号 |
 | `DOTENV_PRIVATE_KEY_STAGING` | ステージング環境の復号 |
 | `DOTENV_PRIVATE_KEY_PREVIEW` | Preview環境の復号（Neon環境変数含む） |
 | `DOTENV_PRIVATE_KEY_PRODUCTION` | 本番デプロイ時の復号 |
@@ -302,11 +303,6 @@ dotenvx採用により、GitHub Secretsは**環境ごとに1つの秘密鍵の
 - [デプロイセットアップ手順](../../instructions/deployment-setup.md)
 <!-- @einja:managed:end -->
 
----
-
-<!-- @einja:seed:start id="environment-variables-project" -->
-## プロジェクト固有の設定
-
-<!-- このセクションはプロジェクト固有の内容を追記する場所です -->
-<!-- einja syncで上書きされません -->
-<!-- @einja:seed:end -->
+<!-- @einja:project-private:start id="environment-variables-project" -->
+<!-- プロジェクト固有の情報を記入 -->
+<!-- @einja:project-private:end -->

package/presets/default/docs/einja/steering/product.md

@@ -541,11 +541,6 @@ describe('UserRepository', () => {
 すべての開発活動は、このビジョンと原則に従って実施してください。
 <!-- @einja:managed:end -->
 
----
-
-<!-- @einja:seed:start id="product-project" -->
-## プロジェクト固有の設定
-
-<!-- このセクションはプロジェクト固有の内容を追記する場所です -->
-<!-- einja syncで上書きされません -->
-<!-- @einja:seed:end -->
+<!-- @einja:project-private:start id="product-project" -->
+<!-- プロジェクト固有の情報を記入 -->
+<!-- @einja:project-private:end -->