@einja/dev-cli 0.1.37 → 0.1.39

package/presets/default/.claude/commands/einja/einja-sync.md

@@ -0,0 +1,238 @@
+---
+description: "テンプレート同期を実行。dev-cli/create-einja-appのsyncをカテゴリ選択式で実行し、コンフリクトも自動解消します"
+allowed-tools: Bash, AskUserQuestion, Read, Grep, Glob
+---
+
+# テンプレート同期コマンド
+
+## コマンドの目的
+
+`@einja/dev-cli sync` と `create-einja-app sync` をカテゴリ選択式で実行し、テンプレート更新をリポジトリに取り込む。コンフリクト発生時は対話的に解消する。
+
+## 処理フロー
+
+### Step 1: CLI検出
+
+以下のコマンドで利用可能なCLIを検出する。
+
+```bash
+npx @einja/dev-cli --version 2>/dev/null
+npx create-einja-app --version 2>/dev/null
+```
+
+| 検出結果 | 動作 |
+|---------|------|
+| 両方なし | エラーメッセージを表示して終了: `「@einja/dev-cli または create-einja-app が必要です。npm install @einja/dev-cli でインストールしてください。」` |
+| dev-cli のみ | dev-cli カテゴリのみ表示 |
+| create-einja-app のみ | create-app カテゴリのみ表示 |
+| 両方あり | Step 2 の質問1で選択 |
+
+### Step 2: カテゴリ選択（AskUserQuestion）
+
+2段階で同期対象を選択する。
+
+#### 質問1: 同期ソースの選択（両方利用可能な場合のみ）
+
+```yaml
+AskUserQuestion:
+  question: "どのCLIで同期しますか？"
+  header: "同期ソース選択"
+  options:
+    - label: "dev-cli のみ（Claude Code関連ファイル）"
+      description: ".claude/ 配下のcommands, agents, skills, hooks、docs/einja/、.envrc、.vscode/settings.json"
+    - label: "create-einja-app のみ（プロジェクトテンプレート）"
+      description: "biome.json, .gitignore, .github/, Dockerfile, turbo.json, package.json 等のプロジェクト基盤ファイル"
+    - label: "両方"
+      description: "dev-cli → create-einja-app の順で両方実行（推奨）"
+```
+
+片方のみ利用可能な場合はこの質問をスキップする。
+
+#### 質問2: カテゴリ選択
+
+選択されたCLIに応じて、対象カテゴリを選択する。AskUserQuestion の options は最大4つまでのため、以下の形式で提示する。
+
+```yaml
+AskUserQuestion:
+  question: "同期するカテゴリを選択してください"
+  header: "カテゴリ選択"
+  options:
+    - label: "全カテゴリ（デフォルト推奨）"
+      description: "apps, packages を除く全カテゴリを同期します。最も安全で推奨される選択です"
+    - label: "カスタム選択（除外カテゴリを指定）"
+      description: "特定のカテゴリを除外したい場合。次の入力で除外カテゴリをコンマ区切りで指定します"
+```
+
+**「カスタム選択」の場合**: 以下のカテゴリ一覧を表示し、除外したいカテゴリをコンマ区切りで入力してもらう。
+
+**dev-cli カテゴリ一覧:**
+
+| カテゴリ名 | 対象ファイル | デフォルト |
+|-----------|-------------|-----------|
+| `commands` | `.claude/commands/` | ON |
+| `agents` | `.claude/agents/` | ON |
+| `skills` | `.claude/skills/` | ON |
+| `hooks` | `.claude/hooks/` | ON |
+| `docs` | `docs/einja/` | ON |
+| `env` | `.envrc` | ON |
+| `tools` | `.vscode/settings.json` | ON |
+
+**create-einja-app カテゴリ一覧:**
+
+| カテゴリ名 | 対象ファイル | デフォルト |
+|-----------|-------------|-----------|
+| `env` | `.env*`, `.node-version` | ON |
+| `tools` | `biome.json`, `.prettierrc`, `.editorconfig`（※ `.vscode/` はdev-cli管理のため除外） | ON |
+| `git` | `.gitignore`, `.gitattributes` | ON |
+| `git-hooks` | `.husky/` | ON |
+| `github` | `.github/workflows/`, `.github/actions/` | ON |
+| `docker` | `Dockerfile*`, `docker-compose*.yml` | ON |
+| `monorepo` | `turbo.json`, `pnpm-workspace.yaml` | ON |
+| `root-config` | `package.json`, `tsconfig.json` | ON |
+| `scripts` | `scripts/` | ON |
+| `docs` | `README.md`, `docs/` | ON |
+| `apps` | `apps/**` | **OFF** |
+| `packages` | `packages/**` | **OFF** |
+
+> **重複に関する注意**: dev-cli の `tools` は `.vscode/settings.json` のみを管理し、create-einja-app の `tools` は `biome.json` 等を管理する。`.vscode/` 配下は dev-cli 側が管轄するため、create-einja-app の `tools` カテゴリでは `.vscode/` は対象外。
+
+> **デフォルトOFFのカテゴリ**: `apps` と `packages` はデフォルトOFF。これらを同期に含めたい場合は、カスタム選択で明示的に追加する旨をユーザーに伝える（例: 「`+apps,+packages` のように `+` 付きで追加カテゴリを指定できます」）。
+
+### Step 3: dry-run で差分プレビュー
+
+選択されたカテゴリで dry-run を実行し、変更予定の差分をユーザーに表示する。
+
+```bash
+# dev-cli の場合
+npx @einja/dev-cli sync --only <categories> --dry-run --yes
+
+# create-einja-app の場合
+npx create-einja-app sync --categories <categories> --dry-run
+```
+
+> **注**: 両CLIでカテゴリ指定のオプション名が異なる（dev-cli: `--only` / create-einja-app: `--categories`）
+
+- `<categories>` はStep 2で選択されたカテゴリをコンマ区切りで渡す
+- 差分がない場合は「変更はありません」と表示して該当CLIの処理をスキップ
+- 差分がある場合はファイル一覧と変更内容をユーザーに提示
+
+### Step 4: 実行確認 → sync実行
+
+差分プレビューを見せた上で、ユーザーに実行可否を確認する。
+
+```yaml
+AskUserQuestion:
+  question: "上記の変更を適用しますか？"
+  header: "同期実行の確認"
+  options:
+    - label: "はい、実行する"
+      description: "表示された差分の通りにファイルを更新します"
+    - label: "いいえ、キャンセル"
+      description: "変更を適用せずに終了します"
+```
+
+**実行順序**: dev-cli を先に実行し、次に create-einja-app を実行する（dev-cli が Claude Code 設定を先に更新するため）。
+
+```bash
+# dev-cli
+npx @einja/dev-cli sync --only <categories> --yes --json
+
+# create-einja-app
+npx create-einja-app sync --categories <categories>
+```
+
+- dev-cli は `--json` オプションで構造化出力を取得しパースする
+- create-einja-app sync には `--yes` フラグがないが、`--categories` 指定時は対話プロンプトをスキップする
+
+### Step 5: コンフリクト検出 → 手動解消サポート
+
+sync 固有のコンフリクトを検出し、対話的に解消する（git コンフリクトとは異なる）。
+
+#### コンフリクトの検出方法
+
+| CLI | 検出方法 |
+|-----|---------|
+| dev-cli | JSON出力の `status: "partial_success"` かつ `conflicts > 0` |
+| create-einja-app | 標準出力に「コンフリクト」文字列が含まれる |
+
+#### コンフリクト解消フロー
+
+1. **コンフリクトファイルの一覧を取得・表示**
+   - dev-cli: JSON出力の `conflicts` 配列からファイルパスを抽出
+   - create-einja-app: 標準出力から「コンフリクト」を含む行を抽出し、ファイルパスをパース
+   - 取得したファイルパスを表形式で一覧表示
+
+2. **各ファイルの差分内容を確認**
+   - `Read` ツールでコンフリクトファイルの内容を読み込み、差分をユーザーに提示
+
+3. **ユーザーに解決方針を確認**
+
+```yaml
+AskUserQuestion:
+  question: "コンフリクトの解決方針を選択してください"
+  header: "コンフリクト解決"
+  options:
+    - label: "テンプレート優先（リモートの最新版で上書き）"
+      description: "テンプレートの内容を採用し、ローカルのカスタマイズを破棄します"
+    - label: "ローカル優先（現在の内容を維持）"
+      description: "現在のローカルファイルを維持し、テンプレートの変更を破棄します"
+    - label: "手動マージ（1ファイルずつ確認）"
+      description: "各ファイルの差分を確認しながら、手動でマージ内容を決定します"
+```
+
+4. **方針に従って解消**
+   - テンプレート優先: dry-run出力やCLIのコンフリクト情報からテンプレート側の内容を特定し、`Edit` ツールで上書き
+   - ローカル優先: 現在の内容を維持（変更なし）
+   - 手動マージ: テンプレート内容とローカル内容を両方表示し、ユーザーと対話しながら `Edit` で編集
+
+### Step 6: 結果サマリー表示
+
+テーブル形式で同期結果の概要を表示する。
+
+```markdown
+## 同期結果サマリー
+
+| CLI | 成功 | スキップ | コンフリクト |
+|-----|------|---------|------------|
+| dev-cli | 5 | 2 | 1 (解消済み) |
+| create-einja-app | 8 | 3 | 0 |
+| **合計** | **13** | **5** | **1** |
+```
+
+### Step 7: 結果詳細表示
+
+各ファイルの詳細結果を以下の形式で表示する。
+
+```markdown
+### dev-cli sync 詳細
+  ✓ .claude/commands/einja/task-exec.md (更新)
+  ✓ .claude/skills/einja-coding-standards/SKILL.md (更新)
+  ⏭ .claude/agents/einja/task-executer.md (変更なし)
+  ⚠ .claude/hooks/einja/pre-commit.sh (コンフリクト → 解消済み)
+
+### create-einja-app sync 詳細
+  ✨ .github/workflows/ci.yml (新規)
+  ✓ biome.json (更新)
+  ⏭ .gitignore (変更なし)
+```
+
+**アイコンの意味:**
+
+| アイコン | 意味 |
+|---------|------|
+| ✓ | 更新成功 |
+| ✨ | 新規ファイル追加 |
+| ⏭ | 変更なし（スキップ） |
+| ⚠ | コンフリクト発生（解消済み） |
+
+**パース方法:**
+- dev-cli: `--json` 出力の `files` 配列をパースして各ファイルのステータスを表示。JSON形式が不正な場合は標準出力をそのまま表示
+- create-einja-app: 標準出力から `✓` / `⚠️` / `スキップ` 行を抽出して表示。抽出できない場合は標準出力をそのまま表示
+
+## 注意事項
+
+- `npx` 経由で実行するため、利用者側に事前インストールは不要
+- dev-cli は `.vscode/settings.json` を管理し、create-einja-app の `tools` カテゴリでは `.vscode/` 配下は対象外
+- `apps` と `packages` カテゴリはデフォルト OFF。既存の実装コードを上書きするリスクがあるため、明示的な指定が必要
+- コンフリクト解消は sync 固有のもので、git コンフリクトとは異なる。`einja-conflict-resolver` Skill は使用しない
+- 両方のCLIを実行する場合、dev-cli を先に実行すること（Claude Code 設定が先に更新される必要があるため）

package/presets/default/.claude/commands/einja/spec-create.md

@@ -169,7 +169,7 @@ AskUserQuestion:
 1. spec-qa-generatorエージェントで作成
    - requirements.mdとdesign.mdの内容を参照
    - **シナリオテスト（scenarios.md）**: 複数タスクをまたぐ継続操作フローのテスト仕様
-   - **フェーズ別テスト仕様**: 各タスクグループのテスト仕様
+   - **Story別テスト仕様**: 各ユーザーストーリー（AC単位）のテスト仕様
    - 受け入れ基準（AC）との対応付け
 2. **ユーザーに内容確認を依頼**
    - 作成したqa-tests/ディレクトリの構成と概要を提示
@@ -283,7 +283,9 @@ AskUserQuestion:
         ├── design.md        # 設計書（技術詳細）
         └── qa-tests/        # QAテスト仕様
             ├── scenarios.md # シナリオテスト（複数タスクをまたぐフロー）
-            └── phase{N}.md  # 各フェーズのテスト仕様
+            ├── story{N}.md  # 各ストーリーのテスト仕様（AC単位）
+            └── evidence/    # エビデンス（スクリーンショット等）
+                └── story{N}/ # ストーリー別
 
 （注: タスク一覧はGitHub Issueに記述）
 ```
@@ -305,7 +307,9 @@ AskUserQuestion:
         │   └── quality.md           # 品質と運用
         └── qa-tests/                # QAテスト仕様
             ├── scenarios.md         # シナリオテスト（複数タスクをまたぐフロー）
-            └── phase{N}.md          # 各フェーズのテスト仕様
+            ├── story{N}.md          # 各ストーリーのテスト仕様（AC単位）
+            └── evidence/            # エビデンス（スクリーンショット等）
+                └── story{N}/        # ストーリー別
 
 （注: タスク一覧はGitHub Issueに記述）
 ```

package/presets/default/.claude/commands/einja/task-exec.md

@@ -212,7 +212,7 @@ Issue #123 のPhase 99 タスク（タスクグループ 99.1）を実行して
    - 各 AC に対して、Given/When/Then に基づくテストシナリオを作成
    - Integration: API + DB + ミドルウェアの連携テスト
    - Browser: Playwright MCP を使用したユーザーシナリオテスト
-   - QA 仕様書（`qa-tests/phaseN/X-Y.md`）に記録
+   - QA 仕様書（`qa-tests/story{N}.md`）に記録
 
 3. **SUCCESS 判定基準**
    - **検証レベルが「Integration」「Browser」の全ての AC が満たされた場合のみ**、SUCCESS 判定
@@ -272,11 +272,11 @@ task-qa は以下の基準で失敗原因を分類し、適切な戻し先を決
 
 ## QA仕様書の作成・更新フロー
 
-### 初回実行時（qa-tests/phaseN/X-Y.md が存在しない場合）
+### 初回実行時（qa-tests/story{N}.md が存在しない場合）
 
 1. **ファイルの新規作成**
-   - タスクグループ番号に基づいて `qa-tests/phaseN/X-Y.md` を新規作成
-   - 例: タスクグループ1.1 → `qa-tests/phase1/1-1.md`
+   - タスクメタデータの「実装AC」からストーリー番号を特定し、`qa-tests/story{N}.md` を新規作成
+   - 例: 実装AC が AC1.1, AC1.2 → `qa-tests/story1.md`
 
 2. **受け入れ基準の抽出**
    - `requirements.md` の各ユーザーストーリー配下の「受け入れ基準」セクションから各ACを抽出
@@ -303,10 +303,10 @@ task-qa は以下の基準で失敗原因を分類し、適切な戻し先を決
 **ステータス: [✅ SUCCESS / ❌ FAILURE / ⚠️ PARTIAL]**
 ```
 
-### 2回目以降の実行時（qa-tests/phaseN/X-Y.md が既に存在する場合）
+### 2回目以降の実行時（qa-tests/story{N}.md が既に存在する場合）
 
 1. **既存ファイルの読み込み**
-   - `qa-tests/phaseN/X-Y.md` を読み込む
+   - `qa-tests/story{N}.md` を読み込む
 
 2. **更新対象の特定**
    - 「実施結果」セクションのみを更新対象とする

package/presets/default/.claude/settings.json

@@ -1,5 +1,6 @@
 {
   "includeCoAuthoredBy": false,
+  "plansDirectory": "docs/plans",
   "permissions": {
     "allow": [
       "Bash(npm:*)",

package/presets/default/.claude/skills/einja-coding-standards/SKILL.md

@@ -30,9 +30,10 @@ description: "TypeScript/React/Next.jsのコーディング規約とベストプ
 
 各カテゴリの詳細な規約は以下を参照してください：
 
-- [TypeScript規約](./reference/typescript-rules.md) - 型安全性、型定義、禁止事項
-- [命名規則](./reference/naming-conventions.md) - 変数・関数・型の命名規則
-- [禁止事項](./reference/prohibited-patterns.md) - 絶対に使用禁止のパターン
+- [TypeScript規約](./references/typescript-rules.md) - 型安全性、型定義、禁止事項
+- [命名規則](./references/naming-conventions.md) - 変数・関数・型の命名規則
+- [禁止事項](./references/prohibited-patterns.md) - 絶対に使用禁止のパターン
+- [インポートパス規約](./references/import-conventions.md) - パッケージ間・アプリ内のインポートルール
 
 ## クイックリファレンス
 

package/presets/default/.claude/skills/einja-coding-standards/references/import-conventions.md

@@ -0,0 +1,69 @@
+# インポートパスの規約
+
+## パッケージ間のインポート
+
+```typescript
+// 認証機能（共通設定）
+import { baseAuthOptions, mergeAuthOptions } from "@repo/front-core/auth";
+
+// 認証機能（アプリローカル）
+import { auth, signIn, signOut } from "@/lib/auth";
+import { requireAuth, withAuth } from "@/lib/auth/guard";
+
+// データベース
+import { prisma } from "@repo/server-core";
+
+// UIコンポーネント
+import { Button } from "@repo/ui/button";
+import { Card } from "@repo/ui/card";
+import { cn } from "@repo/ui/utils";
+
+// 型定義
+import type { Session } from "next-auth"; // 型拡張はfront-coreで定義済み
+```
+
+## アプリ内のインポート
+
+```typescript
+// apps/web内では従来通り@/を使用
+import { Component } from "@/components/...";
+import { helper } from "@/lib/...";
+```
+
+## 認証設定のパターン
+
+アプリ固有の認証設定は `@/lib/auth/index.ts` で `baseAuthOptions` を拡張します：
+
+```typescript
+import { baseAuthOptions, mergeAuthOptions } from "@repo/front-core/auth";
+import NextAuth from "next-auth";
+
+const authOptions = mergeAuthOptions(baseAuthOptions, {
+  pages: { signIn: "/signin" },  // アプリ固有
+  callbacks: {
+    async redirect({ url, baseUrl }) {
+      // アプリ固有のリダイレクトロジック
+    },
+  },
+});
+
+export const { handlers, signIn, signOut, auth } = NextAuth(authOptions);
+```
+
+## インポート順序
+
+インポート文は以下の順序で記述してください：
+
+1. **Node.js標準ライブラリ**
+2. **外部ライブラリ**
+3. **内部パッケージ** (`@repo/*`)
+4. **アプリ内インポート** (`@/`, `@web/`, `@admin/` 等)
+5. **相対インポート**
+
+各グループ間には空行を入れてください。
+
+## 禁止事項
+
+- **相対パスの使用禁止**: import文で `../` や `./` を使用しない（CSS importやindex.tsからの同階層re-exportを除く）
+- 必ずアプリ固有エイリアス（`@web/*`, `@admin/*` 等）またはパッケージ名（`@repo/server-core` 等）を使用すること
+- **index.ts不使用**: パッケージエクスポートにindex.tsは使わず、直接ファイルパスを指定する（`@repo/server-core/infrastructure/database/client` 等）

package/presets/default/.claude/skills/einja-component-design/SKILL.md

@@ -32,9 +32,9 @@ description: "Reactコンポーネントの設計原則と実装ガイドライ
 
 各カテゴリの詳細な規約は以下を参照してください：
 
-- [ディレクトリ構造](./reference/directory-structure.md) - ファイル配置とディレクトリ設計
-- [Props設計パターン](./reference/props-patterns.md) - Props設計とイベントハンドリング
-- [スタイリングガイド](./reference/styling-guide.md) - Tailwind CSSを使用したスタイリング規約
+- [ディレクトリ構造](./references/directory-structure.md) - ファイル配置とディレクトリ設計
+- [Props設計パターン](./references/props-patterns.md) - Props設計とイベントハンドリング
+- [スタイリングガイド](./references/styling-guide.md) - Tailwind CSSを使用したスタイリング規約
 
 ## クイックリファレンス
 

package/presets/default/.claude/skills/einja-project-overview/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: project-overview
+description: "プロジェクトの全体構成・技術スタックの参照ハブ"
+---
+
+# プロジェクト概要 Skill
+
+## 概要
+
+このSkillは、プロジェクトの全体構成・技術スタックを把握したいときに参照するエントリポイントです。
+
+## プロジェクト概要
+
+- **構成**: Turborepoモノレポ（pnpm workspaces）
+- **アプリ**: `apps/web`（メイン管理画面）
+- **共通パッケージ**: `@repo/config`, `@repo/front-core`, `@repo/server-core`, `@repo/ui`
+
+## 詳細ドキュメント
+
+@docs/einja/steering/architecture.md
+
+## 関連Skill
+
+- [coding-standards](../einja-coding-standards/SKILL.md) - コーディング規約（インポートパス規約含む）
+- [infra-maintenance](../einja-infra-maintenance/SKILL.md) - 開発環境セットアップ・サーバー管理
+- [component-design](../einja-component-design/SKILL.md) - コンポーネント設計ガイドライン
+
+## 頻出コマンド
+
+- `pnpm dev:bg` / `pnpm dev:stop` - 開発サーバー起動/停止
+- `pnpm build` - プロダクションビルド
+- `pnpm lint:fix && pnpm format:fix` - コード自動修正
+- `pnpm typecheck` - 型チェック
+- `pnpm test` - テスト実行
+- `pnpm prepush` - プッシュ前チェック（lint + typecheck + test）