create-einja-app 0.1.1

package/templates/turborepo-pandacss/.cursor/rules/error-handling-rules.mdc

@@ -0,0 +1,188 @@
+---
+description: hono エラーハンドリング
+globs: src/server,src/server/*
+alwaysApply: false
+---
+# エラーハンドリングのプロジェクトルール
+## 概要
+
+本プロジェクトでは、エラーハンドリングに「Result モナド」パターンを採用しています。このドキュメントでは、各層でのエラーハンドリングの責務と実装方法について説明します。
+
+## Result モナドとは
+
+Result モナドは、処理の結果を「成功」または「失敗」として表現するデータ型です。TypeScript では以下のように定義されています：
+
+```typescript
+// 成功時の結果
+type Success<T> = {
+  isSuccess: true;
+  value: T;
+};
+
+// 失敗時の結果
+type Failure<E> = {
+  isSuccess: false;
+  error: E;
+};
+
+// Result型（成功または失敗）
+type Result<T, E> = Success<T> | Failure<E>;
+```
+
+## 各層の責務
+
+### 1. リポジトリ層（データアクセス層）
+
+リポジトリ層は、データベースアクセスに関するエラーを捕捉し、適切な `Result` オブジェクトに変換する責務を持ちます。
+
+**実装ルール**:
+
+- リポジトリのメソッドは `Promise<Result<T, ApplicationError>>` を返すこと
+- データベース操作は try-catch ブロックで囲み、例外を捕捉すること
+- データが存在しない場合は `NOT_FOUND` エラーを返すこと
+- バリデーションエラーは `VALIDATION_ERROR` として返すこと
+- データベース固有のエラーは適切なアプリケーションエラーに変換すること
+
+**実装例**:
+
+```typescript
+async find(userId: string): Promise<Result<prettifiedTafProfile, ApplicationError>> {
+  if (!userId) {
+    return Result.failure(new ApplicationError(ERROR_CODES.VALIDATION_ERROR, 'userIdが指定されていません。'));
+  }
+
+  try {
+    const tafProfile = await prismaClient.tafProfile.findUnique({
+      where: { userId },
+      include: { TafEventRecord: true },
+    });
+
+    if (!tafProfile) {
+      return Result.failure(new ApplicationError(ERROR_CODES.NOT_FOUND, 'TAFプロフィールが見つかりませんでした。'));
+    }
+
+    return Result.success(convertToPrettifiedTafProfile(tafProfile));
+  } catch (error) {
+    return Result.failure(new ApplicationError(ERROR_CODES.SYSTEM_ERROR, 'TAFプロフィールの取得に失敗しました。'));
+  }
+}
+```
+
+### 2. ユースケース層（ビジネスロジック層）
+
+ユースケース層は、ビジネスロジックに関するバリデーションを行い、リポジトリから返された `Result` を適切に処理する責務を持ちます。
+
+**実装ルール**:
+
+- ユースケースのメソッドは `Promise<Result<T, ApplicationError>>` を返すこと
+- ビジネスルールに関するバリデーションを行い、エラーの場合は `Result.failure` を返すこと
+- リポジトリから返された `Result` は、必要に応じて `flatMap` や `map` を使って変換すること
+- 複数のリポジトリ操作を連鎖させる場合は、`flatMap` を使用すること
+
+**実装例**:
+
+```typescript
+export const getUserTafProfileByIdService = async (
+  userId: string
+): Promise<Result<prettifiedTafProfile, ApplicationError>> => {
+  if (!userId) {
+    return Result.failure(
+      new ApplicationError(ERROR_CODES.VALIDATION_ERROR, 'ユーザーIDが指定されていません。')
+    );
+  }
+
+  return await tafProfileRepository.find(userId);
+};
+
+export const postUserTafProfileService = async (
+  userId: string,
+  data: z.infer<typeof tafProfileMutationInputSchema>
+): Promise<Result<{ status: 'success' }, ApplicationError>> => {
+  if (!userId) {
+    return Result.failure(
+      new ApplicationError(ERROR_CODES.VALIDATION_ERROR, 'ユーザーIDが指定されていません。')
+    );
+  }
+
+  const result = await tafProfileRepository.create(userId, data);
+
+  return Result.flatMap(result, _ => {
+    return Result.success({ status: 'success' });
+  });
+};
+```
+
+### 3. プレゼンテーション層（API 層）
+
+プレゼンテーション層は、ユースケースから返された `Result` を適切な HTTP レスポンスに変換する責務を持ちます。
+
+**実装ルール**:
+
+- API 入力パラメータのバリデーションを行うこと（zValidator などを使用）
+  - その際にバリデーションエラーが起きた場合の返却値は、zValidatorの標準挙動に準拠して返却し、明示的なハンドリングは実装しないこと
+- ユースケースから返された `Result` を、`isSuccess` フラグに基づいて適切な HTTP レスポンスに変換すること
+- 成功時は `createSuccessResponse` を使用してレスポンスを生成すること
+- 失敗時は `createErrorResponse` を使用してエラーレスポンスを生成すること
+- レスポンスは `c.json` を使用して返すこと。日付型から文字列への変換はもその関数の内部処理に任せて、明示的な実装での変換は行わないこと
+
+**実装例**:
+
+```typescript
+.get('/:userId', zValidator('param', userIdSchema), async c => {
+  const { userId } = c.req.valid('param');
+  const result = await getUserTafProfileByIdService(userId);
+
+  if (result.isSuccess) {
+    const response = createSuccessResponse(result.value);
+    return c.json(response.data, response.status);
+  } else {
+    const errorResponse = createErrorResponse(result.error);
+    return c.json(errorResponse.error, errorResponse.status);
+  }
+})
+```
+
+## エラーコードとステータスコードのマッピング
+
+エラーコードと HTTP ステータスコードのマッピングは、`errorHandler.ts` で定義されています：
+
+```typescript
+export const ERROR_STATUS_MAP: Record<ApplicationErrorType, StatusCode> = {
+  VALIDATION_ERROR: 400,
+  NOT_FOUND: 404,
+  ALREADY_EXISTS: 409,
+  UNAUTHORIZED: 401,
+  SYSTEM_ERROR: 500,
+} as const;
+```
+
+## モナド操作の活用
+
+Result モナドは、以下の操作を提供しています：
+
+- `Result.success(value)`: 成功結果を生成
+- `Result.failure(error)`: 失敗結果を生成
+- `Result.map(result, fn)`: 成功時の値を変換
+- `Result.flatMap(result, fn)`: 成功時の値を別の Result に変換
+
+特に `flatMap` は、複数の操作を連鎖させる際に有用です。例えば：
+
+```typescript
+// ユーザーを取得し、そのプロフィールを更新する
+const result = await userRepository.findById(userId);
+return Result.flatMap(result, user => {
+  return profileRepository.update(user.id, profileData);
+});
+```
+
+## vitestのテストデータについて
+
+[mockUser.ts](mdc:picker-app/src/server/test/mocks/mockUser.ts)に基本的にmockデータを作成する関数を作成し、テストファイル側では関数を呼び出すだけにする
+
+## まとめ
+
+- infrastracture層: データアクセスエラーを Result モナドに変換
+- UseCase層: ビジネスロジックのバリデーションと Result モナドの処理
+- Presentation層: Result モナドを HTTP レスポンスに変換
+
+このパターンを一貫して適用することで、型安全なエラーハンドリングと明確なコードの意図を実現します。

package/templates/turborepo-pandacss/.cursor/rules/refactor-rules.mdc

@@ -0,0 +1,93 @@
+---
+description: 
+globs: 
+alwaysApply: true
+---
+# リファクタリング方針
+## DRY原則（Don't Repeat Yourself）
+
+### 基本方針
+- 同じコードを2回以上書かない
+- 似たような処理は抽象化して再利用可能にする
+- 共通のロジックは適切な場所に集約する
+
+### 具体的な実践
+- 重複するコードは関数やコンポーネントとして抽出
+- 共通のロジックはユーティリティ関数として実装
+- 定数は定数ファイルに集約
+- 似たような処理は抽象化して再利用可能に
+- 共通のバリデーションロジックは共通関数化
+- 共通のエラーハンドリングは統一する
+
+## コードスメル（改善すべきコードの特徴）
+
+### 関数・メソッド関連
+- 長すぎる関数（20行以上）は分割
+- 引数が多すぎる関数（4つ以上）はオブジェクト化を検討
+- 戻り値の型が複雑な場合は型定義を明確に
+- 副作用のある関数は最小限に
+
+### 制御構造
+- 深すぎるネスト（3段階以上）は避ける
+- 複雑な条件分岐は早期リターンで簡略化
+- マジックナンバーは定数化
+- フラグ変数は列挙型（enum）で管理
+
+### コードの品質
+- コメントアウトされたコードは削除
+- 未使用の変数やインポートは削除
+- デッドコードは削除
+- 一時変数は適切なスコープで使用
+
+## SOLID原則
+
+### 単一責任の原則（Single Responsibility Principle）
+- 1つのクラス/関数は1つの責務のみを持つ
+- 複数の責務を持つ場合は分割を検討
+- 責務の境界を明確に定義
+- 関連する機能は適切にグループ化
+
+### 開放閉鎖の原則（Open-Closed Principle）
+- 既存のコードを修正せずに拡張できる設計
+- 抽象化とインターフェースを活用
+- 新しい機能追加は既存コードの修正を最小限に
+- 拡張ポイントを明確に定義
+
+### リスコフの置換原則（Liskov Substitution Principle）
+- サブクラスは親クラスの動作を壊さない
+- 継承関係は慎重に設計
+- サブクラスは親クラスの契約を守る
+- 継承よりも委譲を優先
+
+### インターフェース分離の原則（Interface Segregation Principle）
+- クライアントが必要としないメソッドを強制しない
+- インターフェースは小さく分割
+- クライアント固有のインターフェースを提供
+- 汎用的なインターフェースは避ける
+
+### 依存性逆転の原則（Dependency Inversion Principle）
+- 高レベルのモジュールは低レベルのモジュールに依存しない
+- 抽象化に依存する設計
+- 依存関係はインターフェースを通じて定義
+- 具象クラスへの直接依存を避ける
+
+## リファクタリングの進め方
+
+### 事前準備
+- テストカバレッジを確認
+- リファクタリング範囲を明確に定義
+- 影響範囲を分析
+- 段階的なアプローチを計画
+
+### 実施手順
+1. テストを書く（既存のテストがなければ）
+2. 小さな変更から始める
+3. 変更ごとにテストを実行
+4. コミット単位を適切に分割
+5. コードレビューを受ける
+
+### 注意事項
+- 機能追加とリファクタリングは分離
+- 大きな変更は段階的に実施
+- パフォーマンスへの影響を考慮
+- ドキュメントの更新を忘れない

package/templates/turborepo-pandacss/.dockerignore

@@ -0,0 +1,126 @@
+# Dependencies
+node_modules
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Next.js
+.next/
+.next
+out/
+
+# Environment variables
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Database
+*.db
+*.sqlite
+*.sqlite3
+
+# Logs
+logs
+*.log
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Coverage directory used by tools like istanbul
+coverage/
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+jspm_packages/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+.parcel-cache
+
+# Next.js build output
+.next
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+
+# Gatsby files
+.cache/
+public
+
+# Storybook build outputs
+.out
+.storybook-out
+
+# Temporary folders
+tmp/
+temp/
+
+# Editor directories and files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Git
+.git
+.gitignore
+README.md
+
+# Docker
+Dockerfile*
+docker-compose*
+.dockerignore

package/templates/turborepo-pandacss/.einja-sync.json

@@ -0,0 +1,35 @@
+{
+  "version": "1.0.0",
+  "lastSync": "2026-01-04T16:21:21.138Z",
+  "templateVersion": "0.1.0",
+  "files": {
+    ".claude/commands/einja/update-docs-by-task-specs.md": {
+      "hash": "6c09bb6748134849e8de535d6cdb382bfe0aeb0a3fb19730e1c7708ceaa283bc",
+      "syncedAt": "2026-01-04T16:21:21.151Z"
+    },
+    ".claude/commands/einja/start-dev.md": {
+      "hash": "944d0009a156ca81a965aa7c2e5555420ea7a9562248ab14e981a6aebe82807c",
+      "syncedAt": "2026-01-04T16:21:21.151Z"
+    },
+    ".claude/commands/einja/frontend-implement.md": {
+      "hash": "900a2fa79b0cd53f3475965e81287085aecdecd8a2e9761a638ff368345aaaee",
+      "syncedAt": "2026-01-04T16:21:21.152Z"
+    },
+    ".claude/agents/einja/task/task-modification-analyzer.md": {
+      "hash": "b0df7e02599d46078ef6712552e0035f1bf577fc48324f6356ec454b6b0eafed",
+      "syncedAt": "2026-01-04T16:21:21.152Z"
+    },
+    ".claude/agents/einja/frontend/frontend-coder.md": {
+      "hash": "1d6db52607fa6ca10f36ba354f98da2155a0214bb417014ef3440ddf1496d2f3",
+      "syncedAt": "2026-01-04T16:21:21.152Z"
+    },
+    ".claude/agents/einja/frontend/frontend-architect.md": {
+      "hash": "1fbc2937cd3d330cc1b852427a2fd6fb4c1070acc3d6de8596acdbac94d73da1",
+      "syncedAt": "2026-01-04T16:21:21.153Z"
+    },
+    ".claude/agents/einja/frontend/design-engineer.md": {
+      "hash": "dcad5e62ac13087ffa2ec870f14bea41e6c4cde333aca5f6878c51a631055c65",
+      "syncedAt": "2026-01-04T16:21:21.153Z"
+    }
+  }
+}

package/templates/turborepo-pandacss/.env.ci

@@ -0,0 +1,25 @@
+#/-------------------[DOTENV_PUBLIC_KEY]--------------------/
+#/            public-key encryption for .env files          /
+#/       [how it works](https://dotenvx.com/encryption)     /
+#/----------------------------------------------------------/
+DOTENV_PUBLIC_KEY_CI="02c888edf6b766c5a9781ab2966c142b5f401e9a9d534aab37d6c0fa5c12a04dfa"
+
+# .env.ci
+# ============================================
+# CI/CD Environment
+# ============================================
+# GitHub Actions等のCI/CD環境用
+# dotenvxで暗号化されます
+#
+# 編集方法: pnpm env:update → 「環境設定を変更」→「CI環境」
+# ============================================
+
+# NextAuth設定
+NEXTAUTH_SECRET=encrypted:BDqRRvYcNnJ5rYo4c8Zhu/lThghcW8b6+7u4+MeaJNlkDWHlWeXwVkMf4NJ61mXSCWckIfyg6CrGsgbt78qJ18mEvf2yBmQr1TZxi+byzT34thNOoks8NCE7YudmVaLv7UCZyncLltOl3ida24BxVKv0TA==
+NEXTAUTH_URL=encrypted:BIsPWaPuZKcIShhWg/mkQ4hAIb5XfJxHq8434VrnPEpqnJMeV9PDvUFd/Ra1sg99z6/dpK49jPCLBjK/Uz0t9AKXUMWNd3f2LgoAViktW/0z8WDRhv7vmSt3TA8vwCWBo09NNweIQovudjbR96xJREShBBIKYA==
+
+# データベース設定（CI用SQLite/PostgreSQL）
+DATABASE_URL="encrypted:BBCXNkJ8IKIWFGCSg/QG1xwAI0NdhSAiOL96KreYtcRPeySngZecHQpHm8LUF3/MvjnyjJMcSBzfiPtDbiaUl4dXxOE8l4z0t+96IfgzOIsXxqy/eQW0qZ3YcZq4L3ioz4+D/jfLPX0BdQ9dh5KLB1KgoT0lydCo4v1jAmQ6Fs/RNQmp42XyKp6o4lNoxQN+BAnmBfASxVzirjLgJ7/JzsFaXRQx6Mo="
+
+# アプリケーション設定
+NODE_ENV=encrypted:BGqfAinM4i1q4jyFHGgDieBnatHXGHLbMsC16tSgMdHLCrnPSsdCS3xddycesRH/jQYR2+pbyAstYbhhL87dDiTXcr66/5QHSVkCSZYzf3Ud/abIT82GqXuvgiLDvlum9YhFNEw=

package/templates/turborepo-pandacss/.env.example

@@ -0,0 +1,35 @@
+# ============================================
+# 環境変数の参考テンプレート
+# ============================================
+# ⚠️ このファイルは直接編集しません
+#
+# 【重要】pnpm dev は毎回 .env を再生成します
+# → 秘密情報は .env.local または .env.personal に書いてください
+#
+# 【ファイル構成】
+#   .env.local（暗号化・Git共有）→ チーム共有の秘密情報
+#        ↓ pnpm dev:setup で復号
+#   .env（作業用・毎回再生成）← このテンプレートがベース
+#        +
+#   .env.personal（個人トークン）→ 個人の秘密情報
+#
+# 詳細: docs/einja/steering/infrastructure/environment-variables.md
+# ============================================
+
+# NextAuth設定
+AUTH_SECRET=your-nextauth-secret-key-here
+NEXTAUTH_URL=http://localhost:3000
+
+# OAuth設定（必要に応じて有効化）
+# AUTH_GOOGLE_ID=your-google-client-id
+# AUTH_GOOGLE_SECRET=your-google-client-secret
+# AUTH_GITHUB_ID=your-github-client-id
+# AUTH_GITHUB_SECRET=your-github-client-secret
+
+# データベース設定
+# pnpm dev 実行時に自動設定されます
+DATABASE_URL="postgresql://postgres:postgres@localhost:25432/main?schema=public"
+
+# アプリケーションポート（複数アプリ対応）
+# pnpm dev 実行時にブランチ名から自動計算されます
+PORT_WEB=3000

package/templates/turborepo-pandacss/.env.personal.example

@@ -0,0 +1,27 @@
+# ============================================
+# 個人用環境変数テンプレート
+# ============================================
+# 【使い方】
+# 1. cp .env.personal.example .env.personal
+# 2. 各トークンを設定
+#
+# 【このファイルについて】
+# - 個人固有のトークン（他人と共有しない）
+# - Git管理外
+# - direnvのロード順: .env → .env.personal（後勝ち）
+#   → チームの設定を個人設定で上書き可能
+#
+# 詳細: docs/einja/steering/infrastructure/environment-variables.md
+# ============================================
+
+# GitHub MCP接続用（Claude Code開発時に必要）
+# 取得方法: https://github.com/settings/tokens/new
+# 必要なスコープ: repo, read:org
+GITHUB_TOKEN=
+
+# Claude Code 実験的機能フラグ
+ENABLE_TOOL_SEARCH=true
+
+# その他の個人用トークン（必要に応じて）
+# OPENAI_API_KEY=
+# ANTHROPIC_API_KEY=

package/templates/turborepo-pandacss/.envrc

@@ -0,0 +1,4 @@
+# .env.local（暗号化）から復号された .env を読み込み
+dotenv_if_exists .env
+# 個人用トークン
+dotenv_if_exists .env.personal

package/templates/turborepo-pandacss/.gitattributes

@@ -0,0 +1,5 @@
+# Auto detect text files and perform LF normalization
+* text=auto
+
+# Symlink handling for Windows compatibility
+docs/templates symlink=auto

package/templates/turborepo-pandacss/.husky/pre-commit

@@ -0,0 +1 @@
+npx lint-staged 

package/templates/turborepo-pandacss/.lintstagedrc.js

@@ -0,0 +1,24 @@
+module.exports = {
+	// Biomeによるリントとフォーマット（CLAUDE.md、.claude/、docs/specs/を除外）
+	"**/*.{js,jsx,ts,tsx,json}": (filenames) => {
+		const filteredFiles = filenames.filter(
+			(filename) =>
+				!filename.includes("CLAUDE.md") &&
+				!filename.includes(".claude/") &&
+				!filename.includes("docs/specs/"),
+		);
+		if (filteredFiles.length === 0) return [];
+		// ステージングされたファイルだけをBiomeに直接渡す（高速）
+		return [`npx biome check --write ${filteredFiles.join(" ")}`];
+	},
+	"**/*.md": (filenames) => {
+		const filteredFiles = filenames.filter(
+			(filename) =>
+				!filename.includes("CLAUDE.md") &&
+				!filename.includes(".claude/") &&
+				!filename.includes("docs/specs/"),
+		);
+		if (filteredFiles.length === 0) return [];
+		return [`npx biome check --write ${filteredFiles.join(" ")}`];
+	},
+};

package/templates/turborepo-pandacss/.mcp.json

@@ -0,0 +1,45 @@
+{
+	"mcpServers": {
+		"vibe_kanban": {
+			"command": "npx",
+			"args": ["-y", "vibe-kanban@latest", "--mcp"]
+		},
+		"codex": {
+			"type": "stdio",
+			"command": "codex",
+			"args": ["mcp-server"]
+		},
+		"context7": {
+			"command": "npx",
+			"args": ["-y", "@upstash/context7-mcp"]
+		},
+		"playwright": {
+			"type": "stdio",
+			"command": "npx",
+			"args": ["-y", "@playwright/mcp", "--isolated"]
+		},
+		"serena": {
+			"command": "uvx",
+			"args": [
+				"--from",
+				"git+https://github.com/oraios/serena",
+				"serena-mcp-server",
+				"--context",
+				"ide-assistant",
+				".",
+				"--enable-web-dashboard=false"
+			]
+		},
+		"github": {
+			"type": "http",
+			"url": "https://api.githubcopilot.com/mcp/",
+			"headers": {
+				"Authorization": "Bearer ${GITHUB_TOKEN}"
+			}
+		},
+		"asana": {
+			"command": "npx",
+			"args": ["mcp-remote", "https://mcp.asana.com/sse"]
+		}
+	}
+}

package/templates/turborepo-pandacss/.node-version

@@ -0,0 +1 @@
+22.16.0 

package/templates/turborepo-pandacss/.templateignore

@@ -0,0 +1,60 @@
+# create-einja-app テンプレート除外設定
+# このファイルはテンプレート更新時に除外するファイル・ディレクトリを定義します
+
+# CLI関連パッケージ
+packages/cli/
+packages/create-einja-app/
+
+# 依存関係・ビルド成果物
+node_modules/
+.next/
+out/
+dist/
+build/
+styled-system/
+
+# Git関連
+.git/
+.github/
+
+# ログファイル
+*.log
+logs/
+
+# 環境変数ファイル
+.env
+.env.local
+.env.*.local
+.env.production
+.env.staging
+.env.development
+
+# IDE設定
+.idea/
+.vscode/settings.json
+
+# OS固有ファイル
+.DS_Store
+Thumbs.db
+
+# テストカバレッジ
+coverage/
+
+# Prisma migrations（テンプレートには含めない）
+packages/database/prisma/migrations/
+
+# Worktree設定（プロジェクト固有）
+worktree.config.json
+
+# タスク実行関連スクリプト（Einja固有）
+scripts/task-vibe-kanban-loop/
+
+# Einja固有のClaude設定
+.claude/agents/einja/
+.claude/commands/einja/
+.claude/skills/einja-*/
+
+# 仕様書・タスク記録（Einja固有のプロジェクト管理ファイル）
+docs/specs/
+modifications/
+qa-tests/

package/templates/turborepo-pandacss/.vscode/extensions.json

@@ -0,0 +1,3 @@
+{
+	"recommendations": ["biomejs.biome", "vitest.explorer", "Prisma.prisma"]
+}