create-einja-app 0.3.1 → 0.3.3

package/templates/default/docs/plans/glittery-swimming-bachman.md

@@ -0,0 +1,78 @@
+# packages層の相対パスインポート禁止を強制する
+
+## Context
+
+import-conventions.md で「`../` や `./` を使用しない」と規定されているが、packages層では強制手段がなく、29ファイルで `../../` 形式の相対パスが使われている。TSConfig paths エイリアス（`@/`）を追加し、既存の相対パスインポートを書き換える。
+
+## 対象ファイル数
+
+| パッケージ | 違反ファイル数 | 備考 |
+|-----------|-------------|------|
+| packages/server-core | 8件 | vitest.config.ts に `@/` alias 定義済み |
+| packages/cli | 13件 | vitest alias 追加必要 |
+| packages/create-einja-app | 8件 | テストファイル中心 |
+
+## 実施内容
+
+### Step 1: TSConfig paths 追加（3ファイル）
+
+各パッケージの `tsconfig.json` に `paths` を追加。IDEの補完・型チェックで `@/` が使えるようになる。
+
+```json
+"compilerOptions": {
+  "paths": {
+    "@/*": ["./src/*"]
+  }
+}
+```
+
+対象:
+- `packages/server-core/tsconfig.json`
+- `packages/cli/tsconfig.json`
+- `packages/create-einja-app/tsconfig.json`（テスト用に `tests/` へのalias も検討）
+
+### Step 2: vitest.config.ts の alias 追加（2ファイル）
+
+server-core は既に定義済み。cli と create-einja-app に追加。
+
+```typescript
+resolve: {
+  alias: {
+    "@": path.resolve(__dirname, "./src"),
+  },
+},
+```
+
+対象:
+- `packages/cli/vitest.config.ts`（存在確認要）
+- `packages/create-einja-app/vitest.config.ts`（存在確認要）
+
+### Step 3: 相対パスインポートを `@/` に書き換え（29ファイル）
+
+例:
+```typescript
+// Before
+import type { User } from "../../../domain/entities/User";
+import { type Result, failure, success } from "../../../core/result";
+
+// After
+import type { User } from "@/domain/entities/User";
+import { type Result, failure, success } from "@/core/result";
+```
+
+### Step 4: ドキュメント更新（1ファイル）
+
+`.claude/skills/einja-coding-standards/references/import-conventions.md` の禁止事項セクションを更新:
+- packages層でも `@/` エイリアスを使用する旨を明記
+- 各パッケージの `@/` が何を指すか記載
+
+### Step 5: 検証
+
+- `pnpm typecheck` — 型チェック通過
+- `pnpm test` — テスト通過（server-core, cli, create-einja-app）
+- `pnpm build` — ビルド通過
+- `grep` で `../../` が残っていないことを確認
+
+## Lint強制について
+
+Biomeの `noRestrictedImports` は完全一致のみでパターンマッチ不可。自動検出は不可のため、コードレビュー + ドキュメントで担保する。

package/templates/default/docs/plans/happy-watching-toast.md

@@ -0,0 +1,56 @@
+# CLAUDE.md ベストプラクティス統合
+
+## Context
+
+外部CLAUDE.mdベストプラクティスとの差分分析を行い、Codex分析・Planレビューの結果を踏まえて、取り入れるべき4つの改善を特定した。
+
+## 対象ファイル
+
+- `CLAUDE.md`
+
+## 変更内容
+
+### 変更1: 基本原則に「設計の見直し」追加（L11の後）
+
+```markdown
+5. **設計の見直し**: 複雑な変更では実装前に「より良い設計はないか」を検討する。ただし単純な修正には不要
+```
+
+### 変更2: ブロッカー対応テーブルに汎用ルール追加（L68の後）
+
+```markdown
+| 想定外の事態全般 | **即座に停止**。無理に推し進めず再計画 |
+```
+
+### 変更3: 完了判定の必須チェックに差分確認追加（L172の後）
+
+```markdown
+- [ ] `git diff` で意図しない変更が混入していないことを確認（`git diff --stat` で変更ファイル一覧を確認）
+```
+
+### 変更4: 報告ルールセクションに進捗報告追加（L142-149）
+
+セクション名を変更し、進捗報告ルールを追加：
+
+**Before:**
+```markdown
+## サブエージェント結果報告のルール
+```
+
+**After:**
+```markdown
+## 報告ルール
+```
+
+L149の後に追加：
+```markdown
+### 進捗報告の原則
+- 複数ステップのタスクでは、各ステップ完了時にユーザーへ進捗を報告する
+- 完了した作業と次のステップを簡潔に示す
+- 問題が発生した場合は即座に共有する
+```
+
+## 検証方法
+
+- CLAUDE.mdの各変更箇所をReadで確認
+- 既存ルールとの矛盾がないことを目視確認

package/templates/default/docs/plans/harmonic-strolling-nebula.md

@@ -0,0 +1,210 @@
+# Vercel環境変数競合解消 + デプロイジョブ動的マトリクス化
+
+## Context
+
+参照コミット:
+1. https://github.com/drlovekoushiki/drlove_demo_app/commit/565dd31 (env競合解消)
+2. https://github.com/drlovekoushiki/drlove_demo_app/commit/1ad3045 (変更検知フィルタ追加)
+3. https://github.com/drlovekoushiki/drlove_demo_app/commit/2cf8bbf (動的マトリクス化)
+4. https://github.com/drlovekoushiki/drlove_demo_app/commit/d12f7c4 (エッジケース対応)
+
+**問題1**: PR環境で`vercel env add`が重複追加・並行PR競合を起こす
+**問題2**: 変更がないアプリもデプロイジョブが走り、各ステップで`should_deploy`条件分岐が冗長
+**問題3**: grep正規表現が数字含む変数名に非対応、空文字値の未注入、changesジョブ失敗時ガード不足
+
+**解決方針**:
+- PR環境: `vercel env add`を廃止し、`--env`フラグで実行時注入
+- stable branches: mainブランチのみ`vercel env add`、他は`--env`注入
+- 変更検知フィルタに`.github/workflows/**`を追加
+- 動的マトリクスで変更のあるアプリのみジョブを生成
+- エッジケース修正を最初から反映
+
+## 変更対象ファイル
+
+| ファイル | 変更内容 |
+|---------|---------|
+| `.github/workflows/deploy-pr-preview.yml` | env sync削除、deploy時`--env`注入 |
+| `.github/workflows/deploy-stable-branches.yml` | 動的マトリクス化、env syncをmain限定、deploy時`--env`注入、フィルタ追加 |
+| `docs/einja/steering/infrastructure/deployment.md` | フロー図・説明を新方式に更新 |
+| `docs/einja/instructions/vercel-cli-reference.md` | 環境変数同期セクションを新方式に更新 |
+| `.claude/skills/einja-infra-maintenance/SKILL.md` | env sync説明をmain限定+`--env`注入に更新 |
+
+## 詳細変更計画
+
+### 1. deploy-pr-preview.yml
+
+#### 1a. 「Sync environment variables to Vercel」ステップを削除（L264-282）
+
+現在のL264-282にある`vercel env rm`/`vercel env add`ループを完全削除。
+
+#### 1b. 「Deploy to Vercel」ステップを変更（L294-300）
+
+**変更後:**
+```yaml
+      - name: Deploy to Vercel
+        id: deploy
+        run: |
+          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 }}
+```
+
+**反映済みエッジケース修正（コミット#4）:**
+- grep正規表現: `[A-Z_][A-Z0-9_]*`（数字含む変数名対応）
+- `ENV_FLAGS+=`を`if`の外に配置（空文字値も`--env`注入）
+
+### 2. deploy-stable-branches.yml
+
+#### 2a. changesジョブ: フィルタ追加 + 動的マトリクス構築
+
+```yaml
+    outputs:
+      web: ${{ steps.filter.outputs.web }}
+      admin: ${{ steps.filter.outputs.admin }}
+      deploy_matrix: ${{ steps.matrix.outputs.matrix }}  # 追加
+```
+
+web/admin両方のフィルタに`.github/workflows/**`追加。新規ステップ追加:
+
+```yaml
+      - name: Build deploy matrix
+        id: matrix
+        run: |
+          MATRIX='[]'
+          if [ "${{ steps.filter.outputs.web }}" = "true" ]; then
+            MATRIX=$(echo "$MATRIX" | jq -c '. + [{"app": "web"}]')
+          fi
+          if [ "${{ steps.filter.outputs.admin }}" = "true" ]; then
+            MATRIX=$(echo "$MATRIX" | jq -c '. + [{"app": "admin"}]')
+          fi
+          echo "matrix=$MATRIX" >> $GITHUB_OUTPUT
+```
+
+#### 2b. deployジョブ: 動的マトリクスに変更 + should_deploy全削除
+
+```yaml
+  deploy:
+    needs: [ci, migrate, changes]
+    if: always() && needs.ci.result == 'success' && (needs.migrate.result == 'success' || needs.migrate.result == 'skipped') && needs.changes.result == 'success' && needs.changes.outputs.deploy_matrix != '[]'
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        include: ${{ fromJSON(needs.changes.outputs.deploy_matrix) }}
+```
+
+- 「Check if deploy is needed」ステップを完全削除
+- 全ステップから`if: steps.check.outputs.should_deploy == 'true'`を削除
+- `Extract alias domain`と`Set Vercel alias`は`if: env.DEPLOY_RUN_ALIAS == 'true'`のみに
+
+#### 2c. env sync関連をmainブランチ限定に + grep修正
+
+if条件を変更し、grep正規表現も数字含む変数名に対応:
+
+```yaml
+      - name: Sync environment variables to Vercel
+        if: github.ref_name == 'main'
+        run: |
+          npx dotenvx run -f ${{ env.DEPLOY_DOTENV_FILE }} -- bash -c '
+            grep -E "^[A-Z_][A-Z0-9_]*=\"?encrypted:" ${{ env.DEPLOY_DOTENV_FILE }} | cut -d= -f1 | while read -r key; do
+              case "$key" in
+                NEON_*) continue ;;
+              esac
+              value="${!key}"
+              if [ -n "$value" ]; then
+                echo "Syncing $key to Vercel (${{ env.DEPLOY_VERCEL_ENV }})..."
+                echo "$value" | vercel env rm "$key" ${{ env.DEPLOY_VERCEL_ENV }} --yes --token=$VERCEL_TOKEN 2>/dev/null || true
+                echo "$value" | vercel env add "$key" ${{ env.DEPLOY_VERCEL_ENV }} --token=$VERCEL_TOKEN
+              fi
+            done
+          '
+        env:
+          DOTENV_PRIVATE_KEY_PRODUCTION: ${{ secrets.DOTENV_PRIVATE_KEY_PRODUCTION }}
+          DOTENV_PRIVATE_KEY_STAGING: ${{ secrets.DOTENV_PRIVATE_KEY_STAGING }}
+          DOTENV_PRIVATE_KEY_DEVELOP: ${{ secrets.DOTENV_PRIVATE_KEY_DEVELOP }}
+```
+
+```yaml
+      - name: Re-pull Vercel Environment after sync
+        if: github.ref_name == 'main'
+```
+
+#### 2d. 「Deploy to Vercel」ステップを`--env`注入に変更
+
+```yaml
+      - name: Deploy to Vercel
+        id: deploy
+        run: |
+          npx dotenvx run -f $DEPLOY_DOTENV_FILE -- bash -c '
+            declare -a ENV_FLAGS=()
+            while IFS= read -r key; do
+              case "$key" in
+                NEON_*|VERCEL_ALIAS_DOMAIN_*|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:" "$DEPLOY_DOTENV_FILE" | cut -d= -f1)
+
+            echo "Deploying with ${#ENV_FLAGS[@]} runtime env vars..."
+            DEPLOY_URL=$(vercel deploy --prebuilt $DEPLOY_PROD_FLAG "${ENV_FLAGS[@]}" --token="$VERCEL_TOKEN")
+            echo "url=$DEPLOY_URL" >> "$GITHUB_OUTPUT"
+          '
+        env:
+          DOTENV_PRIVATE_KEY_PRODUCTION: ${{ secrets.DOTENV_PRIVATE_KEY_PRODUCTION }}
+          DOTENV_PRIVATE_KEY_STAGING: ${{ secrets.DOTENV_PRIVATE_KEY_STAGING }}
+          DOTENV_PRIVATE_KEY_DEVELOP: ${{ secrets.DOTENV_PRIVATE_KEY_DEVELOP }}
+```
+
+**注意**: このプロジェクトでは`DEPLOY_VERCEL_TARGET_FLAG`ではなく`DEPLOY_PROD_FLAG`を使用。
+
+### 3. docs/einja/steering/infrastructure/deployment.md
+
+更新箇所:
+- PRプレビューフローのmermaid図: `環境変数同期` → `vercel deploy --env（実行時注入）`
+- Stableブランチフローのmermaid図: mainのみ環境変数同期、他は`--env`注入
+- フローチャート: 動的マトリクスで変更アプリのみデプロイ
+- 同時PR運用時の注意: 全encrypted環境変数`--env`注入の説明に更新
+- Vercel環境変数の自動同期: mainブランチ限定を明記
+- ワークフロー一覧テーブル: 動的マトリクス、`--env`注入の説明追加
+
+### 4. docs/einja/instructions/vercel-cli-reference.md
+
+更新箇所:
+- 環境変数同期自動化セクション: mainのみ`vercel env add`、他は`--env`注入
+- CI/CD非対話パターン表: `vercel deploy --env`の使い方追記
+
+### 5. .claude/skills/einja-infra-maintenance/SKILL.md
+
+更新箇所:
+- 環境変数同期の説明: mainのみ`vercel env add`、他は`--env`注入
+- ワークフロー一覧テーブル: 動的マトリクス、`--env`注入の説明追加
+- 競合回避ルール: env syncがmain限定であることを明記
+
+## 検証方法
+
+1. YAML構文チェック（両ファイル）
+2. `git diff --stat`で変更が5ファイルのみであることを確認
+3. PR作成後にActionsでの動作確認（推奨）

package/templates/default/docs/plans/idempotent-wiggling-cherny.md

@@ -0,0 +1,122 @@
+# サブエージェント質問プロトコル（PENDING_QUESTIONS）導入
+
+## Context
+
+Claude Code v2.0.56以降、**サブエージェントではAskUserQuestionがシステムレベルでフィルタリングされ動作しない**（GitHub Issue [#12890](https://github.com/anthropics/claude-code/issues/12890), [#20275](https://github.com/anthropics/claude-code/issues/20275)で確認済み）。また**CLAUDE.mdはサブエージェントに自動ロードされない**。
+
+現在8つのエージェントがAskUserQuestionを参照しているが、全て動作しない。Agent toolの`resume`パラメータ（コンテキスト維持で再開）を活用し、親経由で質問するプロトコルを導入する。
+
+## 変更方針
+
+- **共通Skill**にプロトコルを1箇所だけ定義し、全エージェントに`skills:`でpreload
+- **CLAUDE.md**に親側のハンドリングルールを追加
+- 各エージェントの既存AskUserQuestion YAML例は**参照情報として残し**、PENDING_QUESTIONS形式の使用例を併記
+
+## 変更内容
+
+### 1. 共通Skill作成（新規）
+**パス**: `.claude/skills/einja-subagent-question-protocol/SKILL.md`
+
+内容:
+- サブエージェントではAskUserQuestionが動作しない旨の説明
+- PENDING_QUESTIONSフォーマット定義（具体的な出力例付き）
+- AskUserQuestion YAML → PENDING_QUESTIONS形式の変換ガイド
+- ルール: 1回にまとめる、選択肢と背景・影響を含める、resumeで再開後に作業継続
+
+フォーマット例:
+```markdown
+## PENDING_QUESTIONS
+
+以下の不明点の解消が必要です。
+
+### Q1: [質問タイトル]
+**背景**: [なぜこの質問が必要か]
+
+| 選択肢 | 説明 | メリット | デメリット |
+|--------|------|----------|------------|
+| A: [ラベル] | [詳細] | [メリット] | [デメリット] |
+| B: [ラベル] | [詳細] | [メリット] | [デメリット] |
+
+**推奨**: A（[理由]）
+```
+
+### 2. CLAUDE.md（親側ハンドリング追加）
+**パス**: `CLAUDE.md`
+
+「サブエージェント委託ルール」セクション内に追加:
+
+```markdown
+### サブエージェント質問プロトコル（PENDING_QUESTIONS）
+
+サブエージェント出力に `## PENDING_QUESTIONS` が含まれている場合:
+1. 質問内容を解析し、AskUserQuestionでユーザーに確認
+2. Agent toolの`resume`パラメータで同じサブエージェントを再開（コンテキスト維持）
+3. プロンプトにユーザーの回答を含めて渡す
+4. 再度PENDING_QUESTIONSがある場合は同様に処理（最大2回まで）
+```
+
+### 3. 全エージェント定義の更新
+
+#### 3a. issue-specs系（`skills:` フィールド追加 + 「優先順位3」書き換え）
+
+| ファイル | 変更 |
+|---|---|
+| `requirements-generator.md` | `skills:` 追加 + 49-52行目をプロトコル参照1行に |
+| `design-generator.md` | `skills:` 追加 + 103-107行目をプロトコル参照1行に |
+| `qa-generator.md` | `skills:` 追加 + 62行目をプロトコル参照1行に |
+| `tasks-generator.md` | `skills:` 追加 + 95行目をプロトコル参照1行に |
+
+書き換え後:
+```markdown
+- **優先順位3: ユーザーへの確認（最終手段）**
+  - 上記の方法で解決できない場合、preload済みの「サブエージェント質問プロトコル」に従いPENDING_QUESTIONS形式で質問を返却して停止する
+```
+
+#### 3b. task系・architect系（`skills:` にpreload追加 + AskUserQuestion部分に注釈追加）
+
+| ファイル | 変更 |
+|---|---|
+| `task-executer.md` | `skills: []` に追加 + AskUserQuestion YAML例の前に「⚠️ サブエージェントではAskUserQuestionは動作しない。代わりにPENDING_QUESTIONS形式で返却すること」注釈を追加 |
+| `task-reviewer.md` | `skills:` 追加 + 同様の注釈 |
+| `frontend-architect.md` | `skills:` に追加 + 同様の注釈 |
+| `backend-architect.md` | `skills:` に追加 + 同様の注釈 |
+
+**注釈の形式**（各AskUserQuestion YAML例の直前に挿入）:
+```markdown
+> ⚠️ サブエージェントではAskUserQuestionは動作しません。
+> 以下のYAML例は「どんな質問をすべきか」の参照情報です。
+> 実際にはpreload済みの「サブエージェント質問プロトコル」に従い、
+> PENDING_QUESTIONS形式で質問を返却して停止してください。
+```
+
+これにより既存YAML例の情報（選択肢・description・推奨理由）を完全に保持しつつ、プロトコルへの誘導を行う。
+
+### 4. 変更不要なエージェント
+
+Explore, tasks-validator, task-qa（Skill側で処理済み）, task-modification-analyzer, docs-updater, codex-agent, design-engineer, frontend-coder, ui-design-generator
+
+## 変更ファイルまとめ
+
+| # | ファイル | 操作 |
+|---|---|---|
+| 1 | `.claude/skills/einja-subagent-question-protocol/SKILL.md` | **新規作成** |
+| 2 | `CLAUDE.md` | 親側ハンドリング追加 |
+| 3 | `.claude/agents/einja/issue-specs/requirements-generator.md` | skills追加 + 記述置換 |
+| 4 | `.claude/agents/einja/issue-specs/design-generator.md` | skills追加 + 記述置換 |
+| 5 | `.claude/agents/einja/issue-specs/qa-generator.md` | skills追加 + 記述置換 |
+| 6 | `.claude/agents/einja/issue-specs/tasks-generator.md` | skills追加 + 記述置換 |
+| 7 | `.claude/agents/einja/task/task-executer.md` | skills追加 + 注釈追加 |
+| 8 | `.claude/agents/einja/task/task-reviewer.md` | skills追加 + 注釈追加 |
+| 9 | `.claude/agents/einja/frontend-architect.md` | skills追加 + 注釈追加 |
+| 10 | `.claude/agents/einja/backend-architect.md` | skills追加 + 注釈追加 |
+
+## 検証方法
+
+### 静的検証（Grep）
+1. 共通Skillファイルが存在し、PENDING_QUESTIONSフォーマット例が含まれること
+2. CLAUDE.mdに親側ハンドリングセクションが存在すること
+3. 対象8エージェントの`skills:`に`einja-subagent-question-protocol`が含まれること
+
+### 動作検証（手動）
+4. requirements-generatorを意図的に曖昧な要件でフォアグラウンド起動し、PENDING_QUESTIONS形式で質問が返却されることを確認
+5. 返却された質問をAskUserQuestionで確認後、resumeで再開してコンテキストが維持されていることを確認

package/templates/default/docs/plans/import-alias-refactor.md

@@ -0,0 +1,75 @@
+# インポートエイリアス書き換え: packages/server-core
+
+## 実施日
+2026-02-26
+
+## 目的
+packages/server-core の相対パスインポートを `@/` エイリアスに統一し、コードの可読性と保守性を向上させる。
+
+## 変更ファイル一覧
+
+### 1. tsconfig.json 修正
+
+#### `packages/server-core/tsconfig.json`
+- `paths` エイリアスを追加: `@/*` → `./src/*`
+
+### 2. インポートパス書き換え (8ファイル)
+
+| ファイル | 変更内容 |
+|---------|---------|
+| `src/domain/entities/User.test.ts` | `../../testing` → `@/testing` |
+| `src/domain/repository-interfaces/IUserRepository.ts` | `../../core/result`, `../entities/User` → `@/` 形式 |
+| `src/infrastructure/database/mappers/UserMapper.ts` | `../../../domain/entities/User` → `@/domain/entities/User` |
+| `src/infrastructure/database/repositories/UserRepository.ts` | 5箇所の相対パス → `@/` 形式 |
+| `src/infrastructure/database/mappers/UserMapper.test.ts` | `../../../` 形式 → `@/` 形式 |
+| `src/infrastructure/database/repositories/UserRepository.test.ts` | `../../../` 形式、`../client` → `@/` 形式 |
+| `src/testing/factories/index.ts` | `../../__generated__/fabbrica` → `@/__generated__/fabbrica` |
+| `src/testing/factories/user.factory.ts` | 4箇所の相対パス → `@/` 形式 |
+
+### 3. モノレポ対応 (2ファイル)
+
+#### `apps/web/tsconfig.json`
+- `paths` に `@/*` のマッピングを拡張: `["./src/*", "../../packages/server-core/src/*"]`
+- server-core の `@/` エイリアスを解決できるよう設定
+
+#### `apps/admin/tsconfig.json`
+- 同上
+
+## 検証結果
+
+### TypeScript 型チェック
+```bash
+pnpm prepush:typecheck
+```
+✅ 成功 - モジュール解決エラーなし
+
+### Vitest テスト
+```bash
+pnpm --filter @repo/server-core test
+```
+✅ 全59テスト成功
+
+### 影響範囲
+- **破壊的変更**: なし（内部的なインポートパスの変更のみ）
+- **外部API**: 変更なし
+- **ビルド**: 正常
+
+## 技術メモ
+
+### モノレポでのエイリアス解決
+- `@/` エイリアスは **パッケージ内部の相対パス解決** のためのもの
+- 他パッケージから参照する場合、参照元の tsconfig にもエイリアスマッピングが必要
+- 解決方法:
+  1. TypeScript Project References を使用
+  2. 参照元の `paths` に参照先のエイリアスを追加（今回採用）
+
+### vitest.config.ts
+- 既に `alias: { "@": path.resolve(__dirname, "./src") }` が設定済み
+- 変更不要
+
+## 残存課題
+なし
+
+## 次のステップ
+- 他パッケージでも同様に `@/` エイリアス導入を検討
+- `@repo/front-core` などでも統一