create-einja-app 0.3.1 → 0.3.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-einja-app",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "CLI tool to create new projects with Einja Management Template",
   "type": "module",
   "bin": {

package/templates/default/.changeset/config.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.0.0/schema.json",
+  "changelog": ["@changesets/changelog-github", { "repo": "einja-inc/einja-management-template" }],
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "restricted",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": ["@einja/dev-cli", "create-einja-app"]
+}

package/templates/default/.claude/hooks/einja/plan-mode-skill-loader.sh

@@ -0,0 +1,27 @@
+#!/bin/bash
+# plan-mode-skill-loader.sh - Plan mode中にeinja-skill-firstのリマインダーを注入
+#
+# UserPromptSubmit hookとして設定
+# permission_mode == "plan" の場合に、軽量リマインダーをadditionalContextとして注入
+# 毎回注入しても2-3行なのでコスト無視可能。状態管理不要。
+
+set -uo pipefail
+
+input=$(cat)
+
+# permission_modeを取得
+permission_mode=$(echo "$input" | jq -r '.permission_mode // empty')
+
+# Plan mode以外はスキップ
+if [[ "$permission_mode" != "plan" ]]; then
+  exit 0
+fi
+
+# 軽量リマインダーを注入
+# UserPromptSubmit の additionalContext は hookSpecificOutput 内に配置する必要がある
+jq -n '{
+  "hookSpecificOutput": {
+    "hookEventName": "UserPromptSubmit",
+    "additionalContext": "【Plan mode自動リマインダー】計画作成前にeinja-skill-firstの評価を実施してください。.claude/skills/einja-skill-first/SKILL.mdを参照し、スキップ基準に該当しない場合はSkill作成の必要性を評価してください。スキップ基準（単発の小規模修正、既存キーワードトリガー一致、具体的かつ限定的な作業指示、1回限りの作業）に該当する場合は省略可。"
+  }
+}'

package/templates/default/.claude/settings.json

@@ -1,4 +1,7 @@
 {
+  "env": {
+    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
+  },
   "includeCoAuthoredBy": false,
   "plansDirectory": "docs/plans",
   "permissions": {
@@ -75,6 +78,20 @@
       "mcp__playwright__browser_network_requests",
       "mcp__playwright__browser_close",
       "mcp__playwright__browser_resize",
+      "mcp__pencil__batch_design",
+      "mcp__pencil__batch_get",
+      "mcp__pencil__find_empty_space_on_canvas",
+      "mcp__pencil__get_editor_state",
+      "mcp__pencil__get_guidelines",
+      "mcp__pencil__get_screenshot",
+      "mcp__pencil__get_style_guide",
+      "mcp__pencil__get_style_guide_tags",
+      "mcp__pencil__get_variables",
+      "mcp__pencil__open_document",
+      "mcp__pencil__replace_all_matching_properties",
+      "mcp__pencil__search_all_unique_properties",
+      "mcp__pencil__set_variables",
+      "mcp__pencil__snapshot_layout",
       "mcp__serena",
       "mcp__serena__activate_project",
       "mcp__serena__check_onboarding_performed",
@@ -182,9 +199,20 @@
           }
         ]
       }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/einja/plan-mode-skill-loader.sh",
+            "timeout": 5000
+          }
+        ]
+      }
     ]
   },
   "enabledPlugins": {
     "code-simplifier@claude-plugins-official": true
   }
-}
+}

package/templates/default/.claude/skills/cli-package-specs/SKILL.md

@@ -0,0 +1,247 @@
+---
+name: cli-package-specs
+description: "@einja/dev-cli と create-einja-app のビルド・テンプレート仕様リファレンス。ファイルマッピング、マーカー仕様、コピーフィルタ条件を集約"
+---
+
+# CLI パッケージ ビルド・テンプレート仕様リファレンス
+
+## 概要
+
+このSkillは、2つのCLIパッケージのビルドパイプライン・テンプレート仕様を集約したリファレンスです。
+`einja-` プレフィックスを持たないため、`presets/default/` にはコピーされません。
+
+| パッケージ | 役割 |
+|-----------|------|
+| `@einja/dev-cli` (`packages/cli`) | 既存プロジェクトへの `.claude/` 設定・`docs/einja/` 同期。`einja init` / `einja sync` コマンドを提供 |
+| `create-einja-app` (`packages/create-einja-app`) | 新規プロジェクトのスキャフォールディング。テンプレートからプロジェクト全体を生成 |
+
+---
+
+## 1. ビルドパイプライン
+
+### 1.1 `@einja/dev-cli` ビルド
+
+`packages/cli/package.json` L21:
+```
+"prebuild": "node ./scripts/generate-template.mjs && node ./scripts/copy-presets.mjs"
+```
+
+#### Step 1: CLAUDE.md.template 生成
+- **スクリプト**: `packages/cli/scripts/generate-template.mjs`
+- **入力**: プロジェクトルートの `CLAUDE.md`
+- **出力**: `packages/cli/presets/default/CLAUDE.md.template`
+- **処理**:
+  1. `@einja:excluded` マーカー内を除去（L53-56）
+  2. `pnpm install` 等のコマンドをプレースホルダー（`{{INSTALL_COMMAND}}`等）に変換（L25-35, L62-69）
+
+#### Step 2: プリセットファイルコピー + マーカーバリデーション
+- **スクリプト**: `packages/cli/scripts/copy-presets.mjs`
+- **処理順序**:
+  1. `docs/einja/` 配下のマーカーバリデーション（L303-317）
+  2. ディレクトリマッピングに基づくコピー（L47-122）
+  3. 単一ファイルのコピー（L125-156）
+  4. シンボリックリンク情報の `symlinks.json` 出力（L284-295）
+
+### 1.2 `create-einja-app` テンプレート更新
+
+- **スクリプト**: `scripts/_template-update.ts`（ルート）
+- **出力先**: `packages/create-einja-app/templates/default/`
+- **処理**:
+  1. `.templateignore` でフィルタリング（L93-103）
+  2. `README.md` の `@einja:excluded` マーカー除去（L173-185）
+  3. `package.json` の `name` → `{{projectName}}`、`description` → `{{description}}`（L108-131）
+  4. `tsconfig.json` の `@repo/` → `{{packageName}}/`（L136-161）
+  5. `.ts/.tsx/.js/.jsx` の import文 `@repo/` → `{{packageName}}/`（L166-168）
+
+### 1.3 `@einja/dev-cli` プリセット更新（開発用）
+
+- **スクリプト**: `scripts/_cli-template-update.ts`
+- **実行**: `pnpm preset:update`（`packages/cli/package.json` L30）
+- **処理**: `FileCopier` クラスを使用してプロジェクト原本をCLIプリセットにコピー
+
+---
+
+## 2. ファイルマッピング
+
+### 2.1 `@einja/dev-cli` コピー対象（`copy-presets.mjs`）
+
+#### ディレクトリマッピング（L47-122）
+
+| 原本 | コピー先（`presets/default/` 配下） | 備考 |
+|------|--------------------------------------|------|
+| `.claude/agents/einja/` | `.claude/agents/einja/` | |
+| `.claude/commands/einja/` | `.claude/commands/einja/` | |
+| `.claude/skills/einja-*` | `.claude/skills/einja-*/` | 個別列挙（L62-101） |
+| `.claude/hooks/einja/` | `.claude/hooks/einja/` | `cleanParent: true`（L107） |
+| `docs/einja/` | `docs/einja/` | `memory/`, `cli/` を除外（L114） |
+| `scripts/` | `scripts/` | `_` プレフィックスのファイルはスキップ（L247-249） |
+
+#### 単一ファイルマッピング（L125-156）
+
+| 原本 | コピー先 | 必須 |
+|------|---------|------|
+| `.claude/settings.json` | `.claude/settings.json` | Yes |
+| `.mcp.json` | `.mcp.json` | No |
+| `docs/einja/cli/preset.yaml` | `preset.yaml` | Yes |
+| `.envrc` | `.envrc` | Yes |
+| `.vscode/settings.json` | `.vscode/settings.json` | No |
+
+#### 特殊変換
+
+| 原本 | コピー先 | 変換内容 |
+|------|---------|---------|
+| `CLAUDE.md` | `CLAUDE.md.template` | `@einja:excluded` 除去 + プレースホルダー変換（`generate-template.mjs`） |
+
+### 2.2 `FileCopier` クラスのマッピング（`file-copier.ts`）
+
+**ファイル**: `packages/cli/src/lib/preset-update/file-copier.ts`
+
+`FileCopier` は `einja sync` / `preset:update` で使用される。`copy-presets.mjs`（prebuild）とは別のコピーロジック。
+
+ディレクトリマッピング（L44-85）:
+
+| source | destination | category |
+|--------|------------|----------|
+| `.claude/commands` | `.claude/commands/einja` | commands |
+| `.claude/agents` | `.claude/agents/einja` | agents |
+| `.claude/skills` | `.claude/skills` | skills |
+| `.claude/hooks` | `.claude/hooks` | hooks |
+| `docs/einja/steering` | `docs/einja/steering` | docs |
+| `docs/einja/templates` | `docs/einja/templates` | docs |
+| `docs/einja/instructions` | `docs/einja/instructions` | docs |
+| `docs/einja/example` | `docs/einja/example` | docs |
+
+単一ファイルマッピング（L92-104）:
+
+| source | destination | category |
+|--------|------------|----------|
+| `.envrc` | `.envrc` | env |
+| `.vscode/settings.json` | `.vscode/settings.json` | tools |
+
+---
+
+## 3. コピー対象フィルタ
+
+### 3.1 Skills のプレフィックスフィルタ
+
+**ファイル**: `packages/cli/src/lib/preset-update/file-copier.ts` L194-195
+
+```typescript
+// skillsカテゴリの場合、einja-プレフィックスでフィルタリング
+const prefixFilter = mapping.category === "skills" ? "einja-" : undefined;
+```
+
+`.claude/skills/` 配下のトップレベルディレクトリのうち、**`einja-` で始まるもののみ**が配布対象。
+
+- **配布される**: `einja-project-overview/`, `einja-task-commit/`, `einja-skill-creator/` 等
+- **配布されない**: `cli-package-specs/`（このSkill自体）、その他 `einja-` プレフィックスなしのSkill
+
+`copy-presets.mjs` では個別列挙（L62-101）で同等の制御を実現している。
+
+### 3.2 `_` プレフィックスフィルタ
+
+- `copy-presets.mjs` L247-249: `_` で始まるファイル名はスキップ
+- `file-copier.ts` L291: `_` で始まるファイル名はスキップ
+
+### 3.3 隠しファイルフィルタ（`file-copier.ts` のみ）
+
+- L303: `.` で始まるファイル名はスキップ（単一ファイルマッピングで明示されたものを除く）
+
+---
+
+## 4. マーカー仕様
+
+**詳細仕様書**: `packages/cli/docs/MARKER_SPECIFICATION.md`
+**実装**: `packages/cli/src/lib/sync/marker-processor.ts`
+
+### 4.1 `@einja:excluded`
+
+テンプレート生成時に**セクション全体を除去**するマーカー。
+
+```markdown
+<!-- @einja:excluded:start -->
+このセクション内容はテンプレートには含まれない
+<!-- @einja:excluded:end -->
+```
+
+- `generate-template.mjs` L53-56: CLAUDE.md → CLAUDE.md.template 変換時に除去
+- `template-update.ts` L56-67: create-einja-app テンプレート（README.md等）で除去
+- `_template-update.ts` L173-185: 同上
+
+### 4.2 `@einja:managed`
+
+`einja sync` 実行時に**常にテンプレート版で上書き**されるセクション。
+
+```markdown
+<!-- @einja:managed:start -->
+共通ルール（sync時に最新版で上書き）
+<!-- @einja:managed:end -->
+```
+
+- ID属性はオプション: `<!-- @einja:managed:start id="section-a" -->`
+- `marker-processor.ts` L16-17: パース用正規表現
+
+### 4.3 `@einja:project-private`
+
+`einja sync` 実行時に**初回のみ追加、以降はユーザー編集を保持**するセクション。
+
+```markdown
+<!-- @einja:project-private:start id="commit-rules-project" -->
+プロジェクト固有の設定（ユーザーが自由に編集）
+<!-- @einja:project-private:end -->
+```
+
+- **ID属性は必須**（`marker-processor.ts` L174-181 でバリデーション）
+- レガシー `@einja:seed` マーカーとの後方互換あり（L44-53, L303-307）
+
+### 4.4 マーカーバリデーション
+
+`packages/cli/scripts/validate-markers.mjs` がビルド時（`copy-presets.mjs` L303-317 から呼び出し）に実行。
+
+| チェック項目 | エラータイプ |
+|------------|------------|
+| start/end ペア一致 | `unpaired_start` / `unpaired_end` |
+| ネスト禁止 | `nested` |
+| project-private に ID 必須 | `project_private_without_id` |
+| ID 重複禁止 | `duplicate_id` |
+
+---
+
+## 5. `post-setup.ts` 処理フロー
+
+**ファイル**: `packages/create-einja-app/src/generators/post-setup.ts`
+
+`create-einja-app` でプロジェクト生成後に実行されるセットアップフロー。
+
+| Step | 処理 | 行番号 |
+|------|------|--------|
+| 0 | 初回セットアップ（`scripts/init.sh` 実行: Volta/Node.js/pnpm/direnv） | L57-64 |
+| 1 | 依存関係インストール（`pnpm install`） + Prismaクライアント生成（`pnpm db:generate`） | L68-87 |
+| 2 | 秘密鍵の自動ローテーション（`pnpm env:rotate-secrets --all --non-interactive`） | L90-99 |
+| 3 | Git初期化（`git init` → `git add .` → `git commit`） | L102-113 |
+| 4 | `@einja/dev-cli` 初期化（`npx @einja/dev-cli@latest init --force --no-backup`、`config.setupEinjaCli` が true の場合のみ） | L116-125 |
+| 5 | 完了メッセージ表示 | L128 |
+
+---
+
+## 6. `setup-dev.ts` 処理フロー
+
+**ファイル**: `scripts/setup-dev.ts`
+
+既存プロジェクトの開発環境セットアップスクリプト。
+
+| Step | 処理 | 行番号 |
+|------|------|--------|
+| 1 | Volta インストール確認 | L158-191 |
+| 2 | Volta シェル設定（`VOLTA_FEATURE_PNPM`） | L194-213 |
+| 3 | Node.js / pnpm インストール（`volta install`） | L216-249 |
+| 4 | direnv インストール確認（macOS: `brew install direnv`） | L324-355 |
+| 5 | シェル設定（`direnv hook` を rc ファイルに追加） | L358-376 |
+| 6 | dotenvx インストール | L379-419 |
+| 7 | `.env` ファイル作成（`.env.local` から復号、worktree 対応） | L422-517 |
+| 8 | `.env.personal` 作成 + `GITHUB_TOKEN` 対話設定 | L519-585 |
+| 9 | direnv 有効化（`direnv allow`） | L588-594 |
+| 10 | データベース起動（`docker-compose up -d postgres`） | L597-625 |
+| 11 | データベース初期化（`pnpm db:generate` + `pnpm db:push`） | L610-613 |
+
+worktree 環境では `.env.keys` をメインリポジトリから自動コピーする機能あり（L45-67, L73-90）。

package/templates/default/.einja-sync.json

@@ -3,7 +3,7 @@
   "lastSync": "2026-01-04T16:21:21.138Z",
   "templateVersion": "0.1.0",
   "files": {
-    ".claude/commands/einja/update-docs-by-task-specs.md": {
+    ".claude/commands/einja/update-docs-by-issue-specs.md": {
       "hash": "6c09bb6748134849e8de535d6cdb382bfe0aeb0a3fb19730e1c7708ceaa283bc",
       "syncedAt": "2026-01-04T16:21:21.151Z"
     },

package/templates/default/.env.personal.example

@@ -19,8 +19,12 @@
 # 必要なスコープ: repo, read:org
 GITHUB_TOKEN=
 
-# Claude Code 実験的機能フラグ
-ENABLE_TOOL_SEARCH=true
+# Asana APIトークン（プロジェクト管理ツールAsanaのAPIアクセス用）
+# 取得方法: https://app.asana.com/0/my-apps で個人アクセストークンを追加
+ASANA_TOKEN=
+
+# Serena MCPサーバーのポート番号（ポート衝突時のみ変更。通常は自動解決）
+# SERENA_PORT=9851
 
 # その他の個人用トークン（必要に応じて）
 # OPENAI_API_KEY=

package/templates/default/.envrc

@@ -23,6 +23,11 @@ MAIN_WORKTREE=$(get_main_worktree)
 if [ -n "$MAIN_WORKTREE" ] && [ -f "$MAIN_WORKTREE/.env.personal" ]; then
   dotenv_if_exists "$MAIN_WORKTREE/.env.personal"
 fi
+
+# Serena MCP サーバー自動起動
+if [ -n "$MAIN_WORKTREE" ] && [ -f "$MAIN_WORKTREE/scripts/ensure-serena.sh" ]; then
+  source "$MAIN_WORKTREE/scripts/ensure-serena.sh" "$MAIN_WORKTREE"
+fi
 # @einja:managed:end
 
 # @einja:seed:start id="project-env"

package/templates/default/.github/release.yml

@@ -0,0 +1,10 @@
+changelog:
+  exclude:
+    labels: ["dependencies", "skip-changelog"]
+  categories:
+    - title: "New Features"
+      labels: ["enhancement", "feature"]
+    - title: "Bug Fixes"
+      labels: ["bug", "fix"]
+    - title: "Other Changes"
+      labels: ["*"]

package/templates/default/.github/workflows/changeset-status.yml

@@ -0,0 +1,60 @@
+name: Changeset Status
+
+on:
+  pull_request:
+    branches: [main, staging]
+    types: [opened, synchronize, reopened]
+
+jobs:
+  changeset-check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Check for changesets
+        id: check
+        run: |
+          COUNT=$(ls .changeset/*.md 2>/dev/null | grep -cv README.md || echo 0)
+          echo "count=$COUNT" >> $GITHUB_OUTPUT
+          echo "has_changesets=$([[ $COUNT -gt 0 ]] && echo true || echo false)" >> $GITHUB_OUTPUT
+
+      - name: Comment on PR
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const count = parseInt('${{ steps.check.outputs.count }}');
+            const hasChangesets = '${{ steps.check.outputs.has_changesets }}' === 'true';
+            const marker = '<!-- changeset-status -->';
+
+            let body;
+            if (hasChangesets) {
+              body = `${marker}\n### ✅ Changeset detected\n\nThis PR includes **${count}** changeset(s). A release will be created when merged.`;
+            } else {
+              body = `${marker}\n### ⚠️ No changeset found\n\nThis PR does not include a changeset. If this PR includes user-facing changes, please run:\n\n\`\`\`bash\npnpm changeset\n\`\`\`\n\nIf this change doesn't need a release (docs, CI, config), you can ignore this message.`;
+            }
+
+            // Find existing comment
+            const comments = await github.rest.issues.listComments({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+            });
+            const existing = comments.data.find(c => c.body.includes(marker));
+
+            if (existing) {
+              await github.rest.issues.updateComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                comment_id: existing.id,
+                body,
+              });
+            } else {
+              await github.rest.issues.createComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: context.issue.number,
+                body,
+              });
+            }

package/templates/default/.github/workflows/deploy-pr-preview.yml

@@ -261,26 +261,6 @@ jobs:
             echo "name=$PROJECT_NAME" >> $GITHUB_OUTPUT
           fi
 
-      # Vercel環境変数の自動同期（encrypted-only方式：dotenvxで管理しているもの = Vercelに同期すべきもの）
-      - name: Sync environment variables to Vercel
-        run: |
-          # .env.previewから encrypted: を含むキー名を抽出
-          # NEON_*とDATABASE_*を除外（Neon APIから動的取得・--envで注入するため）
-          ENCRYPTED_KEYS=$(grep 'encrypted:' $GITHUB_WORKSPACE/.env.preview | sed 's/=.*//' | grep -vE '^(NEON_|DATABASE_)')
-
-          npx dotenvx run -f $GITHUB_WORKSPACE/.env.preview -- bash -c "
-            for key in $ENCRYPTED_KEYS; do
-              value=\$(printenv \"\$key\" 2>/dev/null || true)
-              if [ -n \"\$value\" ]; then
-                echo \"Syncing \$key to Vercel (preview)...\"
-                echo \"\$value\" | vercel env rm \"\$key\" preview --yes --token=\$VERCEL_TOKEN 2>/dev/null || true
-                echo \"\$value\" | vercel env add \"\$key\" preview --token=\$VERCEL_TOKEN
-              fi
-            done
-          "
-        env:
-          DOTENV_PRIVATE_KEY_PREVIEW: ${{ secrets.DOTENV_PRIVATE_KEY_PREVIEW }}
-
       # NOTE: dotenvxはデフォルトで既存の環境変数を上書きしない
       # env:で設定したDATABASE_URLがNeonブランチのURLとして優先される
       - name: Build Project (apps/${{ matrix.app }})
@@ -291,13 +271,32 @@ jobs:
           DOTENV_PRIVATE_KEY_PREVIEW: ${{ secrets.DOTENV_PRIVATE_KEY_PREVIEW }}
           DATABASE_URL: ${{ steps.db-urls.outputs.db_url_pooled }}
 
-      # Vercel Deploy（ランタイムにもDATABASE_URLを渡す）
       - name: Deploy to Vercel
         id: deploy
         run: |
-          DEPLOY_URL=$(vercel deploy --prebuilt --token=$VERCEL_TOKEN \
-            --env DATABASE_URL="${{ steps.db-urls.outputs.db_url_pooled }}")
-          echo "url=$DEPLOY_URL" >> $GITHUB_OUTPUT
+          npx dotenvx run -f $GITHUB_WORKSPACE/.env.preview -- bash -c '
+            declare -a ENV_FLAGS=()
+            while IFS= read -r key; do
+              case "$key" in
+                NEON_*|DOTENV_PUBLIC_KEY_*) continue ;;
+              esac
+              value="${!key}"
+              if [ -n "$value" ]; then
+                echo "::add-mask::${value}"
+              fi
+              ENV_FLAGS+=("--env" "${key}=${value}")
+            done < <(grep -E "^[A-Z_][A-Z0-9_]*=\"?encrypted:" "$GITHUB_WORKSPACE/.env.preview" | cut -d= -f1)
+
+            # DATABASE_URLはNeon APIから取得した値を注入（.env.previewには含まれない）
+            ENV_FLAGS+=("--env" "DATABASE_URL=${DATABASE_URL}")
+
+            echo "Deploying with ${#ENV_FLAGS[@]} runtime env vars..."
+            DEPLOY_URL=$(vercel deploy --prebuilt "${ENV_FLAGS[@]}" --token="$VERCEL_TOKEN")
+            echo "url=$DEPLOY_URL" >> "$GITHUB_OUTPUT"
+          '
+        env:
+          DOTENV_PRIVATE_KEY_PREVIEW: ${{ secrets.DOTENV_PRIVATE_KEY_PREVIEW }}
+          DATABASE_URL: ${{ steps.db-urls.outputs.db_url_pooled }}
 
       - name: Set Vercel alias
         if: steps.project-name.outputs.name != ''