create-einja-app 0.3.2 → 0.3.3

package/templates/default/docs/plans/agile-munching-knuth.md

@@ -0,0 +1,161 @@
+# Plan: create-einja-app を Claude Code から実行可能にする
+
+## Context
+
+`create-einja-app` CLI は inquirer v12 による対話的プロンプトを使用しているため、Claude Code の Bash ツール（非対話実行のみ）からは実行できない。AskUserQuestion で回答を収集し、CLI 引数として渡す方式で解決する。
+
+**2段階の実装:**
+1. CLI に非対話モード（全パラメータの CLI 引数化）を追加
+2. Claude Code コマンドを作成し、AskUserQuestion → CLI 引数変換の仲介を行う
+
+## スコープ
+
+- `create` コマンドのみ（`sync` コマンドは対象外 — 既に `einja:einja-sync` Skill が存在）
+- 既存の対話モードは完全に維持（後方互換）
+
+---
+
+## Step 1: `CliConfigOverrides` 型の追加
+
+**ファイル:** `packages/create-einja-app/src/types/index.ts`
+
+```typescript
+export type CliConfigOverrides = {
+  packageScope?: string;
+  authMethod?: "default" | "none";
+  setupEinjaCli?: boolean;
+  useCurrentDir?: boolean;
+  postgresPort?: number;
+  containerName?: string;
+  appId?: string;
+  portRangeStart?: number;
+  rangeSize?: number;
+};
+```
+
+## Step 2: commander オプション追加
+
+**ファイル:** `packages/create-einja-app/src/cli.ts`
+
+既存の `--skip-git`, `--skip-install` に加えて以下を追加:
+
+| フラグ | 説明 |
+|--------|------|
+| `-y, --yes` | 非対話モード（デフォルト値使用） |
+| `--scope <scope>` | パッケージスコープ |
+| `--auth <method>` | 認証方式: `default` \| `none` |
+| `--no-einja-cli` | einja CLI セットアップをスキップ |
+| `--use-current-dir` | カレントディレクトリに展開 |
+| `--postgres-port <port>` | PostgreSQL ポート |
+| `--container-name <name>` | Docker コンテナ名 |
+| `--app-id <id>` | アプリ ID |
+| `--port-range-start <port>` | ポート範囲開始 |
+| `--range-size <size>` | ポート範囲サイズ |
+
+## Step 3: `create.ts` の 3 パターン分岐
+
+**ファイル:** `packages/create-einja-app/src/commands/create.ts`
+
+### 3.1 `CreateOptions` 拡張
+
+CLI引数の全フィールドを受け取れるよう拡張。
+
+### 3.2 `validateCliOverrides()` 追加
+
+CLI 引数のバリデーション（scope 正規表現、auth 値チェック、ポート番号範囲）。エラー時は `process.exit(1)`。
+
+### 3.3 メインフロー変更
+
+```
+options.yes → パターンA: 完全非対話（デフォルト + overrides）
+overrides あり → パターンB: 部分指定（未指定フィールドのみ対話）
+それ以外 → パターンC: 完全対話（従来通り）
+```
+
+### 3.4 `buildConfigWithDefaults()` 追加
+
+`--yes` 時にデフォルト値 + overrides から `ProjectConfig` を構築。既存の L80-95 のハードコード部分をこの関数に統合。
+
+## Step 4: `project.ts` の overrides 対応
+
+**ファイル:** `packages/create-einja-app/src/prompts/project.ts`
+
+- `promptProjectConfig(defaultProjectName?, overrides?)` にシグネチャ変更
+- 各質問に `when: () => overrides?.xxx === undefined` を追加し、CLI 引数で指定済みの項目をスキップ
+- worktree 関連 overrides が 1 つでもある場合、`customizeWorktree` 質問をスキップ（カスタマイズ済みとみなす）
+- 最終的な return で `overrides?.xxx ?? answers.xxx` のマージ
+
+## Step 5: `post-setup.ts` の非対話対応
+
+**ファイル:** `packages/create-einja-app/src/generators/post-setup.ts`
+
+- `PostSetupOptions` に `yes?: boolean` を追加
+- `yes === true` 時は `promptAndExecuteDirenvAllow` の inquirer をスキップし、デフォルト動作（direnv allow 実行）
+
+## Step 6: Claude Code コマンド作成
+
+**ファイル:** `.claude/commands/einja/create-app.md`
+
+AskUserQuestion で回答を収集し、CLI 引数に変換して実行するコマンド。
+
+### フロー
+
+```
+1. AskUserQuestion: プロジェクト名（テキスト入力）
+2. AskUserQuestion: 基本設定 3問同時
+   - パッケージスコープ（@repo / @{プロジェクト名} / カスタム）
+   - 認証方式（NextAuth.js / なし）
+   - einja CLI セットアップ（はい / いいえ）
+3. AskUserQuestion: Worktree カスタマイズ（はい / いいえ）
+4. (条件付き) AskUserQuestion: Worktree 詳細設定
+5. ビルド + CLI 実行:
+   pnpm -F create-einja-app build
+   node packages/create-einja-app/dist/cli.js <name> --yes \
+     --scope <scope> --auth <auth> [--no-einja-cli] [worktree flags] \
+     --skip-install
+6. 結果報告
+```
+
+**注意:** `--skip-install` をデフォルトで付与（Claude Code 内でのインストールは別途制御）
+
+## Step 7: テスト
+
+### ユニットテスト
+- `overrides` マージの正確性
+- CLI 引数バリデーションのエラーケース
+
+### 統合テスト
+- `--yes` でデフォルト生成
+- `--yes --scope @custom --auth none` でカスタム生成
+- 部分指定（`--scope` のみ）で残りが対話入力されること
+
+### 手動検証
+```bash
+# 非対話モード
+node packages/create-einja-app/dist/cli.js test-proj --yes --skip-git --skip-install
+
+# 部分指定
+node packages/create-einja-app/dist/cli.js test-proj --scope @test --skip-git --skip-install
+```
+
+---
+
+## 変更ファイル一覧
+
+| ファイル | 変更内容 |
+|---------|---------|
+| `packages/create-einja-app/src/types/index.ts` | `CliConfigOverrides` 型追加 |
+| `packages/create-einja-app/src/cli.ts` | commander オプション追加 |
+| `packages/create-einja-app/src/commands/create.ts` | 3パターン分岐、バリデーション、デフォルト構築 |
+| `packages/create-einja-app/src/prompts/project.ts` | overrides 対応、`when` 条件追加 |
+| `packages/create-einja-app/src/generators/post-setup.ts` | `yes` オプション追加 |
+| `.claude/commands/einja/create-app.md` | 新規: AskUserQuestion 仲介コマンド |
+| テストファイル（既存 + 新規） | 非対話モードのテストケース追加 |
+
+## 検証方法
+
+1. `pnpm -F create-einja-app build` が成功すること
+2. `pnpm -F create-einja-app typecheck` が成功すること
+3. `pnpm -F create-einja-app test` が成功すること
+4. 手動で `--yes` モード実行し、プロジェクトが正しく生成されること
+5. Claude Code から `/einja:create-app` で実行できること

package/templates/default/docs/plans/agile-riding-nova.md

@@ -0,0 +1,158 @@
+# Plan: セットアップフロー統合ドキュメント作成
+
+## Context
+
+`scripts/init.sh`、`post-setup.ts`、`setup-dev.ts` など複数のセットアップ関連ファイルがあるが、
+**どの操作でどのファイルが呼ばれ何が起きるか**を横断的にまとめたドキュメントが存在しない。
+3つのシナリオ（create-einja-app初回 / einja sync / clone後セットアップ）ごとのフローを
+mermaid図 + テーブルで整理したドキュメントを作成する。
+
+## 変更ファイル
+
+| ファイル | 変更内容 |
+|---------|---------|
+| `docs/einja/instructions/setup-flow.md` | **新規作成** セットアップフロー統合ドキュメント |
+| `README.md` | 「パッケージ利用者向け」+「開発環境セットアップ」にドキュメント参照リンクを追加 |
+
+> **NOTE**: `docs/einja/instructions/` はこのリポジトリが原本。ビルド時に `presets/default/` へ自動コピーされ、`einja sync` で各プロジェクトに配布される。直接 `presets/default/` を編集する必要はない。
+
+## TODO
+
+### TODO-1: `docs/einja/instructions/setup-flow.md` 新規作成
+
+3シナリオのセットアップフローを網羅するドキュメントを作成する。
+
+#### ドキュメント構成
+
+```
+# セットアップフローガイド
+
+## 概要
+  - 3つのシナリオの簡潔な説明
+
+## シナリオ別フロー
+
+### 1. npx create-einja-app（新規プロジェクト作成）
+  - mermaid シーケンス図
+  - 処理テーブル（ファイル → 処理内容）
+
+### 2. git clone 後の環境構築（既存プロジェクトへの参加）
+  - mermaid シーケンス図
+  - 処理テーブル
+
+### 3. einja sync（テンプレート同期）
+  - mermaid シーケンス図
+  - 処理テーブル（dev-cli sync / create-einja-app sync）
+
+## ファイル別リファレンス
+  - 各スクリプト/ファイルの役割と呼び出し元の逆引きテーブル
+
+## 処理の重複と設計意図
+  - init.sh と dev:setup の重複箇所の説明（冪等性の意図）
+```
+
+#### シナリオ1: `npx create-einja-app` フロー
+
+```
+ユーザー: npx create-einja-app my-app
+  │
+  ├── cli.ts → createCommand()
+  │     ├── 対話プロンプト（プロジェクト名、スコープ、認証方式等）
+  │     ├── generateTemplate() ← generators/template.ts
+  │     │     └── テンプレートコピー + 変数置換 + リネーム
+  │     └── execPostSetup() ← generators/post-setup.ts
+  │           ├── Step 0: bash scripts/init.sh (stdio: inherit)
+  │           │     ├── Step 1: Volta インストール（未導入時のみ）
+  │           │     ├── Step 2: シェル設定（VOLTA_FEATURE_PNPM）
+  │           │     ├── Step 3: Node.js / pnpm インストール
+  │           │     ├── Step 4: pnpm install
+  │           │     └── Step 5: direnv allow（direnv存在時のみ）
+  │           ├── PATH補完（~/.volta/bin を process.env.PATH に追加）
+  │           ├── Step 1: pnpm install + pnpm db:generate
+  │           ├── Step 2: pnpm env:rotate-secrets --all --non-interactive
+  │           ├── Step 3: git init + git add . + git commit
+  │           ├── Step 4: npx @einja/dev-cli init（setupEinjaCli=true時のみ）
+  │           └── 完了メッセージ表示
+```
+
+#### シナリオ2: clone後の環境構築フロー
+
+```
+開発者: git clone → cd project
+  │
+  ├── ./scripts/init.sh（手動実行・初回のみ）
+  │     ├── Step 1: Volta インストール
+  │     ├── Step 2: シェル設定
+  │     ├── Step 3: Node.js / pnpm インストール
+  │     ├── Step 4: pnpm install
+  │     └── Step 5: direnv allow
+  │
+  ├── exec $SHELL（ターミナル再起動）
+  │
+  ├── pnpm dev:setup（= tsx scripts/setup-dev.ts）
+  │     ├── Step 1-3: Volta確認 / シェル設定 / Node.js・pnpm インストール
+  │     ├── Step 4: direnv インストール（macOS: brew install direnv）
+  │     ├── Step 5: direnv hook シェル追記
+  │     ├── Step 6: dotenvx インストール
+  │     ├── Step 7: .env 作成（.env.local + .env.keys で復号）
+  │     ├── Step 8: .env.personal 作成 + GITHUB_TOKEN（対話入力）
+  │     ├── Step 9: direnv allow → .envrc評価（Serena MCP自動起動含む）
+  │     ├── Step 10: PostgreSQL 起動（docker-compose up -d postgres）
+  │     └── Step 11: pnpm db:generate + pnpm db:push
+  │
+  └── pnpm dev:bg（開発サーバー起動）
+```
+
+#### シナリオ3: einja sync フロー
+
+```
+開発者: einja sync（Claude Code Skill経由）
+  │
+  ├── dev-cli sync
+  │     ├── 同期対象:
+  │     │     ├── .claude/commands/einja/, .claude/agents/einja/
+  │     │     ├── .claude/skills/einja-*/, .claude/hooks/
+  │     │     ├── docs/einja/, scripts/
+  │     │     ├── .envrc（envカテゴリ, 単一ファイル）
+  │     │     └── .vscode/settings.json（toolsカテゴリ, 単一ファイル）
+  │     ├── マージ: 3方向マージ + マーカーベース
+  │     ├── コンフリクト解消（対話式）
+  │     └── 依存関係チェック + インストール
+  │
+  └── create-einja-app sync
+        ├── 同期対象: CI/CD, docker, monorepo設定, root config, scripts/
+        ├── テンプレート変数置換あり
+        └── バックアップ作成 + マージ
+```
+
+#### ファイル別リファレンステーブル
+
+| ファイル | 役割 | 呼び出し元 |
+|---------|------|-----------|
+| `scripts/init.sh` | Volta/Node/pnpm/direnv 初期導入 | create-einja-app (post-setup.ts) / 手動実行 |
+| `scripts/setup-dev.ts` | 環境構築一式（.env, DB, direnv等） | `pnpm dev:setup` |
+| `scripts/ensure-serena.sh` | Serena MCP サーバー起動 | `.envrc` (direnv) |
+| `scripts/env-rotate-secrets.ts` | 秘密鍵ローテーション | create-einja-app (post-setup.ts) / `pnpm env:rotate-secrets` |
+| `.envrc` | dotenv読み込み + worktree間.env.personal共有 + Serena MCP起動 | direnv（シェルディレクトリ進入時に自動評価） |
+| `generators/post-setup.ts` | プロジェクト作成後のセットアップ | create-einja-app create コマンド |
+| `generators/template.ts` | テンプレート展開・変数置換 | create-einja-app create コマンド |
+| `generators/sync.ts` | テンプレート同期 | create-einja-app sync コマンド |
+| `packages/cli/src/commands/sync.ts` | Claude Code関連ファイル同期 | dev-cli sync コマンド |
+
+### TODO-2: README.md に参照リンク追加
+
+**対象**: `README.md` の「パッケージ利用者向け」セクション（L8付近）
+
+「使い分けガイド」の後に、セットアップフローガイドへの参照を1行追加:
+
+```markdown
+> 📖 各シナリオのセットアップで何が実行されるかの詳細は [セットアップフローガイド](docs/einja/instructions/setup-flow.md) を参照してください。
+```
+
+また「パッケージ開発者向け > 開発環境セットアップ」セクション（L158付近）にも同様のリンクを追加。
+
+## 検証
+
+1. ドキュメントのmermaid図がGitHubで正しくレンダリングされるか確認
+2. README.mdのリンクが正しいパスを指しているか確認
+3. `git diff --stat` で意図しないファイルが含まれていないこと

package/templates/default/docs/plans/agile-wibbling-dusk.md

@@ -0,0 +1,91 @@
+# Plan: create-einja-app 利用者体験の改善（3問題の修正）
+
+## Context
+
+create-einja-appの利用者がプロジェクト作成〜起動までの過程で3つの問題に遭遇している:
+1. `scripts/init.sh` が Permission Denied（実行権限なし）
+2. `pnpm install` が `init.sh` と `post-setup.ts` で二重実行される
+3. READMEにトラブルシューティング情報が不足
+
+## 修正内容
+
+### TODO-1: template.ts に `.sh` ファイルの実行権限付与処理を追加
+
+**対象**: `packages/create-einja-app/src/generators/template.ts`
+
+`generateTemplate()` 関数の末尾（変数置換ループ後、L279付近）に `.sh` ファイルへの `chmod +x` 処理を追加:
+
+```typescript
+import { chmodSync } from "node:fs";
+// ...
+// シェルスクリプトに実行権限を付与
+const shFiles = glob.sync("**/*.sh", {
+  cwd: targetPath,
+  absolute: true,
+  dot: true,
+});
+for (const file of shFiles) {
+  chmodSync(file, 0o755);
+}
+```
+
+- `node:fs` から `chmodSync` をインポート
+- テンプレートは `.gitignore` で git 管理外のため、ソース権限でなくコピー後に明示付与する方式
+- `fs-extra` の `copySync` はパーミッションを保持するが、ソース自体が 644 のため chmod が必要
+
+### TODO-2: init.sh から `pnpm install` を削除（2ファイル）
+
+**対象**:
+- `scripts/init.sh` (L77-81) — 原本
+- `packages/create-einja-app/templates/default/scripts/init.sh` (同箇所) — テンプレート配布物
+
+両ファイルからStep 4（依存関係インストール）を削除する。理由:
+- `post-setup.ts` の Step 1 で `pnpm install` を spinner付きで実行済み
+- init.sh は「ツール導入」（Volta/Node/pnpm バイナリのインストール）に専念させる
+- 二重実行の排除 + Volta PATH未反映でのインストール失敗を回避
+
+Step 4 を削除し、旧Step 5（direnv設定）を Step 4 に繰り上げ。完了メッセージの「次のステップ」に `pnpm install` を追記。
+
+※ `presets/default/scripts/init.sh` はビルド時に自動コピーされるため直接編集不要
+
+### TODO-3: README にトラブルシューティング項目を追加
+
+**対象**: `packages/create-einja-app/README.md` (L333付近、既存トラブルシューティングセクション末尾)
+
+追加する項目:
+1. **`scripts/init.sh` が Permission Denied** — `bash scripts/init.sh` で実行するか、`chmod +x scripts/*.sh` で権限付与
+2. **Volta環境でpnpmが見つからない** — `npm install -g pnpm@latest-10` で手動インストール、またはターミナル再起動
+
+### TODO-4: テストのモック順修正
+
+**対象**: `packages/create-einja-app/tests/unit/generators/post-setup.test.ts`
+
+`post-setup.ts` の実際の実行順序:
+```
+Step 0: init.sh
+Step 1: pnpm install → pnpm db:generate
+Step 2: pnpm env:rotate-secrets
+Step 3: git init → git add → git commit
+Step 4: npx @einja/dev-cli init（条件付き）
+```
+
+現在のテストでモック順が実行順序と不一致のケース（L193-240）を修正:
+- 「pnpm installに失敗した場合」(L193): `init.sh成功 → pnpm install失敗` に修正
+- 「Prismaクライアント生成に失敗した場合」(L206): `init.sh成功 → pnpm install成功 → pnpm db:generate失敗` に修正
+- 「@einja/dev-cli initに失敗した場合」(L222): 正しい順序に修正
+
+## 対象ファイル一覧
+
+| ファイル | 変更 |
+|---------|------|
+| `packages/create-einja-app/src/generators/template.ts` | `chmodSync` 追加 |
+| `scripts/init.sh` | Step 4 (pnpm install) 削除 |
+| `packages/create-einja-app/templates/default/scripts/init.sh` | 同上 |
+| `packages/create-einja-app/README.md` | トラブルシューティング追記 |
+| `packages/create-einja-app/tests/unit/generators/post-setup.test.ts` | モック順修正 |
+
+## 検証方法
+
+1. `pnpm -F create-einja-app test` でユニットテスト通過を確認
+2. `pnpm prepush` (lint + typecheck + test) で全体通過を確認
+3. テンプレートからプロジェクト生成し、`./scripts/init.sh` が直接実行できることを確認

package/templates/default/docs/plans/ancient-watching-otter.md

@@ -0,0 +1,152 @@
+# Plan: OrbStack推奨統一 + CLAUDE.md修正 + GitHub自動セットアップ + パッケージ仕様Skill
+
+## Context
+
+1. `create-einja-app` がGitHubリポジトリの作成・設定を行っていない
+2. Docker環境でOrbStackを推奨に統一したい
+3. CLAUDE.mdの「マネージドディレクトリ（編集禁止）」は下流リポジトリ向けルールであり、このテンプレートリポジトリ（原本）では `docs/einja/` は編集可能
+4. 2パッケージ（`@einja/dev-cli`, `create-einja-app`）のビルド仕様を毎回確認するのが手間なので、Skillとして参照できるようにする
+
+---
+
+## TODO-0: パッケージ仕様参照Skill作成
+
+### 目的
+`@einja/dev-cli` と `create-einja-app` の2パッケージのビルド・テンプレート仕様を、既存ドキュメント・コードへの参照として1箇所にまとめる。配布しない（このリポジトリ専用）。
+
+### 作成ファイル
+- `.claude/skills/cli-package-specs/SKILL.md`
+
+### 命名理由
+`einja-` プレフィックスなし → `file-copier.ts:195` のフィルタにより `presets/default/` にコピーされない
+
+### 内容（参照ベース）
+- 2パッケージの概要と役割
+- ビルドパイプライン
+  - `packages/cli/scripts/generate-template.mjs`: CLAUDE.md → CLAUDE.md.template（`@einja:excluded` 除去 + プレースホルダー変換）
+  - `packages/create-einja-app/scripts/template-update.ts`: テンプレートファイルコピー（CLAUDE.mdは無変換でコピー）
+  - `scripts/_cli-template-update.ts`: CLIプリセット更新（`FileCopier` 経由、CLAUDE.mdは対象外）
+  - `scripts/_template-update.ts`: create-einja-appテンプレート更新（README.mdのみexcluded除去）
+- ファイルマッピング（CLAUDE.md「CLIパッケージの二重管理禁止」テーブル参照）
+- コピー対象フィルタ: `.claude/skills/einja-*/` のみ配布（`file-copier.ts:195`）
+- マーカー仕様: `@einja:excluded`, `@einja:project-private`, `@einja:managed`
+- `post-setup.ts` の処理フロー参照
+- `setup-dev.ts` の処理フロー参照
+
+---
+
+## TODO-1: CLAUDE.md excludedセクション修正
+
+### 変更方針
+マネージドディレクトリセクション自体は残す（下流リポジトリ向けに正しいルール）。`@einja:excluded` ブロック内に以下2点を追加。
+
+### 変更内容（`CLAUDE.md` excludedセクション内）
+
+#### 1. パッケージ仕様Skillの参照指示を追加
+
+```markdown
+### パッケージビルド仕様（テンプレートリポジトリ限定）
+
+`@einja/dev-cli` と `create-einja-app` の2パッケージのビルド・テンプレート仕様については、以下のSkillを参照すること:
+
+`.claude/skills/cli-package-specs/SKILL.md`
+```
+
+#### 2. マネージドディレクトリのオーバーライド注記を追加
+
+```markdown
+### マネージドディレクトリの編集について（テンプレートリポジトリ限定）
+
+このリポジトリは `docs/einja/` の**原本（Single Source of Truth）**である。
+上記「マネージドディレクトリ（編集禁止）」ルールは下流リポジトリ（create-einja-appで生成されたプロジェクト）向けであり、
+**このリポジトリでは `docs/einja/` 配下の全ファイルを編集してよい**。
+変更はビルド時に `presets/default/` へ自動コピーされる。
+```
+
+### 対象ファイル
+- `CLAUDE.md`（excludedセクション内 L218付近）
+
+---
+
+## TODO-2: OrbStack推奨に統一
+
+### 2-1. `scripts/setup-dev.ts` 修正（L621-625）
+
+Docker未インストール時のメッセージをOS別に分岐し、macOSではOrbStack推奨:
+
+```typescript
+} else {
+    warn("Dockerがインストールされていません");
+    const platform = getPlatform();
+    if (platform === "macos") {
+        console.log(colors.yellow("  OrbStack（Docker互換の軽量ツール）のインストールを推奨します:"));
+        console.log(colors.cyan("    brew install orbstack"));
+        console.log(colors.gray("  または: https://orbstack.dev/"));
+    } else if (platform === "windows") {
+        console.log(colors.yellow("  Dockerをインストールしてください:"));
+        console.log(colors.gray("    https://docs.docker.com/desktop/install/windows-install/"));
+    } else {
+        console.log(colors.yellow("  Docker Engineをインストールしてください:"));
+        console.log(colors.gray("    https://docs.docker.com/engine/install/"));
+    }
+    console.log(colors.gray("  インストール後、以下を実行してください:"));
+    console.log(colors.gray("    docker-compose up -d postgres"));
+    console.log(colors.gray("    pnpm db:generate && pnpm db:push"));
+}
+```
+
+### 2-2. `docs/einja/instructions/deployment-setup.md` 修正（L38）
+
+```
+Before: | Docker | [Docker Desktop](https://www.docker.com/products/docker-desktop/) | PostgreSQL実行 |
+After:  | Docker | macOS: [OrbStack](https://orbstack.dev/)（推奨）/ その他: [Docker Engine](https://docs.docker.com/engine/install/) | PostgreSQL実行 |
+```
+
+### 2-3. `docs/einja/instructions/local-server-environment-and-worktree.md` 修正（L62-63）
+
+```
+Before:
+  - macOS: [Docker Desktop for Mac](https://docs.docker.com/desktop/install/mac-install/)
+  - Windows: [Docker Desktop for Windows](https://docs.docker.com/desktop/install/windows-install/)
+
+After:
+  - macOS: [OrbStack](https://orbstack.dev/)（推奨。`brew install orbstack`）
+  - Windows: [Docker Desktop for Windows](https://docs.docker.com/desktop/install/windows-install/)
+```
+
+### 対象ファイル
+- `scripts/setup-dev.ts` (L596-625)
+- `docs/einja/instructions/deployment-setup.md` (L38)
+- `docs/einja/instructions/local-server-environment-and-worktree.md` (L62-63)
+
+---
+
+## TODO-3: GitHub自動セットアップスクリプト作成
+
+### 概要
+`scripts/init-github.ts` を新規作成。`pnpm init:github` で実行。
+
+### 処理フロー
+1. `gh` CLIの存在確認（なければインストール案内して終了）
+2. `gh auth status` で認証確認
+3. `git remote get-url origin` でリモート有無確認
+4. リモートなし → org/repo名を対話入力（デフォルト: ディレクトリ名）→ `gh repo create`
+5. `git push -u origin main`
+6. Branch Protection設定（`gh api`）
+7. GitHub Secrets設定（`.env.keys` から読み取り → `gh secret set`）
+8. Environments作成（production, preview）
+
+### 対象ファイル
+- `scripts/init-github.ts`（新規）
+- `package.json`（`"init:github"` スクリプト追加）
+- `scripts/setup-dev.ts`（完了メッセージに `pnpm init:github` 案内追加）
+
+---
+
+## 検証方法
+
+1. **Skill**: `.claude/skills/cli-package-specs/SKILL.md` が存在し、参照先のファイルパスが正しいこと
+2. **CLAUDE.md**: excludedセクション内にオーバーライド注記があること
+3. **OrbStack**: `grep -r "Docker Desktop"` でsetup-dev.tsとdocs 2ファイルに残っていないこと
+4. **init-github.ts**: `pnpm init:github --help` が動作すること
+5. `pnpm prepush` が通ること

package/templates/default/docs/plans/bright-sauteeing-bumblebee.md

@@ -0,0 +1,30 @@
+# Plan: AskUserQuestion の選択肢に description 必須記載ルールを追加
+
+## Context
+AskUserQuestionの選択肢を提示する際、`label` だけでは判断材料が不足する。`description` フィールドに詳細説明・注意点・トレードオフを必ず記載するルールをCLAUDE.mdに追加し、パッケージ利用者全体に適用する。
+
+**仕様確認結果**: AskUserQuestionの選択肢フィールドは `label`（必須）、`description`（必須）、`markdown`（任意）の3つ。`note` フィールドは存在しない。
+
+## 変更内容
+
+### 対象ファイル
+- `CLAUDE.md` L163-166「提示形式」セクション
+
+### 修正内容
+「提示形式」セクションを以下に書き換え:
+
+```markdown
+### 提示形式
+- テーブル形式: 複数項目の比較
+- 番号付きリスト: 詳細説明が必要な場合
+- 推奨オプションには `（推奨）` と理由を付記
+
+### 選択肢の記述ルール
+- 各選択肢の `description` に**必ず詳細説明・注意点・補足**を記載する
+- トレードオフ、影響範囲、前提条件など判断に必要な情報を含める
+- ラベルだけで選択させない。ユーザーが十分な情報に基づいて判断できるようにする
+```
+
+## 検証
+- CLAUDE.mdの変更箇所をReadで確認
+- `presets/default/CLAUDE.md.template` はビルド時に自動生成されるため手動更新不要