create-einja-app 0.3.1 → 0.3.3

package/templates/default/docs/plans/enchanted-wiggling-ember-agent-a5befd57d0ca4c7c7.md

@@ -0,0 +1,177 @@
+# レビューレポート: enchanted-wiggling-ember.md
+
+レビュー実施日: 2026-03-05
+
+---
+
+## 前回指摘事項の反映確認
+
+| 指摘番号 | 内容 | 反映状況 |
+|---------|------|---------|
+| 1 | 命名の一貫性: `issue-spec-requirements-generator` → 短縮名 | 反映済み（requirements-generator.md 等） |
+| 2 | sync-cursor-commands の更新が必要 | TG-2.3 に追加済み |
+| 3 | エージェント名の長さ: ディレクトリ名でスコープ担保 | 反映済み（issue-specs/ + 短縮ファイル名） |
+| 4 | task-exec リネーム不要 | そのまま維持（妥当） |
+
+前回指摘 4 点はすべて反映されている。
+
+---
+
+## 新たに発見された問題
+
+### 重大（見落とすと壊れる）
+
+#### [CRITICAL-1] copy-presets.mjs の Skill 固定列挙に新Skillが含まれていない
+
+**実態**: `packages/cli/scripts/copy-presets.mjs` の Skill コピーは固定列挙（ハードコード）。
+現在の列挙に含まれているのは以下のみ：
+- einja-conflict-resolver
+- einja-general-context-loader
+- einja-output-format
+- einja-spec-context-loader
+- einja-project-overview
+- einja-skill-creator
+- einja-task-commit
+- einja-task-qa
+
+**問題**: 新規作成される以下の Skill が列挙に入っていないため、ビルド（`pnpm build`）しても `presets/default/` にコピーされない：
+- `einja-issue-spec-create`（新規）
+- `einja-task-exec`（新規）
+- `einja-issue-spec-generator`（リネーム後）
+- `einja-issue-spec-validator`（リネーム後）
+
+また、`einja-task-spec-generator` と `einja-task-spec-validator` の **削除エントリ** も必要。
+
+**対処**: Phase 2 の TG として「`copy-presets.mjs` への新 Skill 追加 + 旧 Skill 削除」を追加する必要がある。
+
+#### [CRITICAL-2] issue-exec.md の更新箇所が「2箇所」では足りない
+
+**実態**: `issue-exec.md` の `/einja:task-exec` 参照は **少なくとも3箇所**：
+- 103行目: 代替手段の説明
+- 206行目: Worker 起動手順の説明
+- 394行目: tmux send-keys の実際のコマンド文字列
+
+計画書には「2箇所」と記載されているが、394行目のコマンド文字列が漏れると Worker 起動が壊れる。
+
+**対処**: TG-2.3 の issue-exec.md 更新対象を「全件」に修正すること。
+
+#### [CRITICAL-3] grep 検証パターンに複数の見逃しがある
+
+現在の TG-3.1 grep パターンの欠落：
+
+| 欠落しているチェック | 実際に残存する箇所 |
+|--------------------|------------------|
+| `agents/specs/`（einja/ なしの短縮形） | sync-cursor-commands.md:54 |
+| `.cursor/commands/` 内の旧ファイル残存 | .cursor/commands/update-docs-by-task-specs.md |
+| `README.md` 内の旧コマンド参照 | README.md:60 |
+
+また、誤検知ノイズになる箇所（除外が必要）：
+- `docs/specs/issues/**/qa-tests/` — 履歴エビデンスなので除外推奨
+- `docs/plans/` — 過去計画ファイルなので除外推奨
+- `modifications/` — 作業記録なので除外推奨
+
+**対処**: TG-3.1 の grep コマンドを修正し、除外パターンに `docs/specs/` `docs/plans/` `modifications/` `packages/create-einja-app/templates/default/docs/plans/` を追加する。また、`agents/specs/` と `.cursor/commands/` のチェックを追加する。
+
+---
+
+### 中リスク（計画漏れ）
+
+#### [MEDIUM-1] README.md の更新が計画に含まれていない
+
+**実態**: `README.md` 60行目に以下の記述がある：
+```
+`.claude/commands/` - `/einja:spec-create`, `/einja:task-exec` などのスラッシュコマンド
+```
+
+TG-2.5 は CLAUDE.md のみで、README.md が含まれていない。
+
+**対処**: TG-2.5 に README.md を追加する（Skill/コマンドテーブルの記述を更新）。
+
+#### [MEDIUM-2] sync-cursor-commands.md のパス例示が現実と不一致
+
+**実態**: `sync-cursor-commands.md` 54行目：
+```
+spec-requirements-generator → .claude/agents/specs/spec-requirements-generator.md
+```
+実際のパスは `.claude/agents/einja/specs/` だが、例示では `agents/specs/` と短縮されている。
+リネーム後は `.claude/agents/einja/issue-specs/requirements-generator.md` になる。
+
+TG-2.3 で「エージェントパス agents/specs/ → agents/issue-specs/」と記載されているが、
+このパターンで置換すると `agents/einja/specs/` を持つパスには一致しない可能性がある。
+
+**対処**: TG-2.3 の sync-cursor-commands.md 更新で、具体的にどの文字列を何に置換するかを明示すること。
+
+#### [MEDIUM-3] .cursor/commands/update-docs-by-task-specs.md の旧ファイル削除が計画されていない
+
+**実態**: `.cursor/commands/update-docs-by-task-specs.md` が存在する。
+`sync-cursor-commands` コマンド再実行で `update-docs-by-issue-specs/RULE.md` が生成されるはずだが、
+旧ファイルの **削除** は自動では行われない（スクリプトが削除しない設計の可能性がある）。
+
+**対処**: TG-3.2（ビルド・テスト）の手順に「`.cursor/commands/` 内の旧ファイル手動削除確認」を追加する。
+
+#### [MEDIUM-4] einja-task-spec-generator/SKILL.md と einja-task-spec-validator/SKILL.md のリンクパス変更が2段階になっている
+
+**実態**:
+- `einja-task-spec-generator/SKILL.md`:101行目 → `../../agents/einja/specs/spec-tasks-generator.md`
+- `einja-task-spec-validator/SKILL.md`:126行目 → `../../agents/einja/specs/spec-tasks-validator.md`
+
+リネーム後（einja-issue-spec-generator/SKILL.md）ではリンクパスを：
+1. ディレクトリ: `specs/` → `issue-specs/`
+2. ファイル名: `spec-tasks-generator.md` → `tasks-generator.md`
+
+の **両方** を変更する必要がある。TG-2.2 の記述では「エージェント名更新」とのみ書かれており、
+パスの `specs/` → `issue-specs/` の変更が明記されていない。
+
+**対処**: TG-2.2 の更新内容に「相対パス内の `specs/` → `issue-specs/` 変更」を明記する。
+
+---
+
+### 更新不要と判断できるもの
+
+| 対象 | 判断 | 理由 |
+|-----|------|------|
+| `docs/specs/issues/**/qa-tests/` 内の旧語 | 更新不要 | 履歴エビデンスなので変更すると証跡が変わる |
+| `docs/plans/` 内の過去計画書の旧語 | 更新不要 | 作業記録。ただし grep 検証からは除外すること |
+| `modifications/` 内の旧語 | 更新不要 | 作業記録 |
+| テストファイル内の旧パス（テストデータ文字列） | 更新不要 | 単なるサンプルデータとして使用。実ファイルパスを参照していない |
+| `packages/cli/presets/default/` 配下 | ビルド後に自動反映 | copy-presets.mjs で上書きされる（ただし Skill の固定列挙更新は必要） |
+
+---
+
+## TG-2.2 の行数確認（Skill ファイル数の計算）
+
+計画書で「TG-2.2: スキル内部参照更新（8ファイル）」とあるが、実際にリストされているのは9行：
+
+1. einja-issue-spec-generator/SKILL.md
+2. einja-issue-spec-validator/SKILL.md
+3. einja-task-qa/SKILL.md
+4. einja-task-qa/references/troubleshooting.md
+5. einja-task-qa/references/usage-patterns.md
+6. einja-task-commit/SKILL.md
+7. einja-general-context-loader/SKILL.md
+8. einja-spec-context-loader/SKILL.md
+9. einja-skill-first/SKILL.md
+
+ヘッダーは「8ファイル」だが実際は9ファイル。minor な誤りだが修正推奨。
+
+---
+
+## 総合評価
+
+### 反映状況
+前回指摘 4 点: 全反映済み。
+
+### 新たなリスク
+- **重大**: 3件（CRITICAL-1〜3）
+- **中リスク**: 4件（MEDIUM-1〜4）
+
+### 最小修正が必要な計画変更
+
+1. **新規 TG を追加**: `copy-presets.mjs` の Skill 固定列挙更新（CRITICAL-1）
+2. **TG-2.3 修正**: issue-exec.md の更新箇所を「全件（少なくとも3箇所）」に修正（CRITICAL-2）
+3. **TG-3.1 修正**: grep パターンに `agents/specs/` チェック追加、`.cursor/commands/` チェック追加、除外パターンに `docs/specs/` `docs/plans/` `modifications/` を追加（CRITICAL-3）
+4. **TG-2.5 修正**: README.md を追加（MEDIUM-1）
+5. **TG-2.3 修正**: sync-cursor-commands.md の置換文字列を具体的に明示（MEDIUM-2）
+6. **TG-3.2 修正**: .cursor/commands/ 旧ファイル削除確認を追加（MEDIUM-3）
+7. **TG-2.2 修正**: 相対パス内の `specs/` → `issue-specs/` 変更を明記（MEDIUM-4）
+8. **ヘッダー修正**: TG-2.2 の「8ファイル」→「9ファイル」（minor）

package/templates/default/docs/plans/enchanted-wiggling-ember.md

@@ -0,0 +1,170 @@
+# task-spec → issue-spec リネーム + コマンド→Skill移行
+
+## Context
+
+現在の仕様書関連の命名（`spec-create`, `task-spec-*`, `agents/specs/`）はIssue単位で仕様書を作成するという実態と乖離している。`issue-spec` に統一することで意味的な明確さを向上させる。同時に、`spec-create` と `task-exec` をコマンドからSkillへ移行し、呼び出し方法を統一する。
+
+## リネーム対応表
+
+### ファイル移動・リネーム
+
+| Before | After |
+|--------|-------|
+| `.claude/commands/einja/spec-create.md` | `.claude/skills/einja-issue-spec-create/SKILL.md` |
+| `.claude/commands/einja/task-exec.md` | `.claude/skills/einja-task-exec/SKILL.md` |
+| `.claude/commands/einja/update-docs-by-task-specs.md` | `.claude/commands/einja/update-docs-by-issue-specs.md` |
+| `.claude/skills/einja-task-spec-generator/` | `.claude/skills/einja-issue-spec-generator/` |
+| `.claude/skills/einja-task-spec-validator/` | `.claude/skills/einja-issue-spec-validator/` |
+| `.claude/agents/einja/specs/` | `.claude/agents/einja/issue-specs/` |
+
+### エージェントファイルリネーム（`issue-specs/` 内）
+
+ディレクトリ名 `issue-specs/` でスコープを担保し、ファイル名は短縮。
+
+| Before | After |
+|--------|-------|
+| `spec-requirements-generator.md` | `requirements-generator.md` |
+| `spec-design-generator.md` | `design-generator.md` |
+| `spec-qa-generator.md` | `qa-generator.md` |
+| `spec-tasks-generator.md` | `tasks-generator.md` |
+| `spec-tasks-validator.md` | `tasks-validator.md` |
+
+### 呼び出し方法の変更
+
+| Before | After |
+|--------|-------|
+| `/einja:spec-create <args>` | Skill tool `einja-issue-spec-create` |
+| `/einja:task-exec <args>` | Skill tool `einja-task-exec` |
+| `/einja:update-docs-by-task-specs <args>` | `/einja:update-docs-by-issue-specs <args>` |
+
+## 実装計画
+
+### Phase 1: ファイル移動・作成（並列実行可能）
+
+**TG-1.1: エージェントディレクトリ移動+ファイルリネーム**
+- `git mv .claude/agents/einja/specs/ .claude/agents/einja/issue-specs/`
+- 各ファイルを `git mv` で短縮名にリネーム（`spec-X-generator` → `X-generator`）
+- 対象: 5ファイル
+
+**TG-1.2: スキルディレクトリリネーム**
+- `git mv .claude/skills/einja-task-spec-generator/ .claude/skills/einja-issue-spec-generator/`
+- `git mv .claude/skills/einja-task-spec-validator/ .claude/skills/einja-issue-spec-validator/`
+- 対象: 4ファイル（SKILL.md × 2 + references/ × 2）
+
+**TG-1.3: spec-create → einja-issue-spec-create Skill移行**
+- `.claude/skills/einja-issue-spec-create/SKILL.md` を新規作成（spec-create.mdの内容を移行）
+- 旧 `.claude/commands/einja/spec-create.md` を削除
+- 内部のエージェントパス参照を `../../agents/einja/issue-specs/{短縮名}` に更新
+
+**TG-1.4: task-exec → einja-task-exec Skill移行**
+- `.claude/skills/einja-task-exec/SKILL.md` を新規作成（task-exec.mdの内容を移行）
+- 旧 `.claude/commands/einja/task-exec.md` を削除
+
+**TG-1.5: update-docs-by-task-specs リネーム**
+- `git mv` でファイルリネーム → `update-docs-by-issue-specs.md`
+- 内部テキストの `task-specs` → `issue-specs` 更新
+
+### Phase 2: 参照更新（Phase 1完了後、並列実行可能）
+
+**TG-2.1: エージェント内部参照更新**（10ファイル）
+
+| ファイル | 更新内容 |
+|---------|---------|
+| `.claude/agents/einja/issue-specs/tasks-generator.md` | Skillリンク `../../skills/einja-task-spec-generator/` → `../../skills/einja-issue-spec-generator/`、`spec-create` → `einja-issue-spec-create` |
+| `.claude/agents/einja/issue-specs/tasks-validator.md` | Skillリンク `../../skills/einja-task-spec-validator/` → `../../skills/einja-issue-spec-validator/`、`spec-create` → `einja-issue-spec-create` |
+| `.claude/agents/einja/issue-specs/requirements-generator.md` | `name:` フィールド更新、内部テキストの旧名参照 |
+| `.claude/agents/einja/issue-specs/design-generator.md` | 同上 |
+| `.claude/agents/einja/issue-specs/qa-generator.md` | 同上 |
+| `.claude/agents/einja/task/task-executer.md` | `/einja:spec-create` → `einja-issue-spec-create`、task-exec コマンド→Skill 文言更新 |
+| `.claude/agents/einja/task/task-reviewer.md` | `task-exec` コマンド参照更新 |
+| `.claude/agents/einja/task/task-modification-analyzer.md` | `task-exec` コマンド参照更新 |
+| `.claude/agents/einja/task/task-qa.md` | `task-exec` 参照更新 |
+| `.claude/agents/einja/docs/docs-updater.md` | `update-docs-by-task-specs` → `update-docs-by-issue-specs` |
+
+**TG-2.2: スキル内部参照更新**（8ファイル）
+
+| ファイル | 更新内容 |
+|---------|---------|
+| `.claude/skills/einja-issue-spec-generator/SKILL.md` | タイトル・内部テキスト: `task-spec-generator` → `issue-spec-generator`、エージェント名更新、相対パス `specs/` → `issue-specs/` 更新 |
+| `.claude/skills/einja-issue-spec-validator/SKILL.md` | タイトル・内部テキスト: `task-spec-validator` → `issue-spec-validator`、エージェント名更新、相対パス `specs/` → `issue-specs/` 更新 |
+| `.claude/skills/einja-task-qa/SKILL.md` | `spec-qa-generator` → `qa-generator`、`task-exec` コマンド→Skill文言 |
+| `.claude/skills/einja-task-qa/references/troubleshooting.md` | `spec-requirements-generator` → `requirements-generator` |
+| `.claude/skills/einja-task-qa/references/usage-patterns.md` | `task-exec` 使用例テキスト更新 |
+| `.claude/skills/einja-task-commit/SKILL.md` | `task-exec` コマンド→Skill文言更新 |
+| `.claude/skills/einja-general-context-loader/SKILL.md` | `/einja:spec-create` → `einja-issue-spec-create` |
+| `.claude/skills/einja-spec-context-loader/SKILL.md` | `/einja:spec-create` → `einja-issue-spec-create`（4箇所） |
+| `.claude/skills/einja-skill-first/SKILL.md` | `spec-create` → `einja-issue-spec-create`（3箇所） |
+
+**TG-2.3: コマンド/設定ファイル参照更新**（4ファイル）
+
+| ファイル | 更新内容 |
+|---------|---------|
+| `.claude/commands/einja/issue-exec.md` | `/einja:task-exec` → `einja-task-exec` Skill（3箇所: 行103, 206, 394） |
+| `.claude/commands/einja/sync-cursor-commands.md` | 変換元パスを Skill パスに更新、エージェントパス `agents/specs/` → `agents/issue-specs/`、エージェント名短縮 |
+| `.claude/commands/einja/update-docs-by-issue-specs.md` | 内部テキスト更新 |
+| `.einja-sync.json` | `update-docs-by-task-specs.md` → `update-docs-by-issue-specs.md`（※他のリネーム対象は未登録のため変更不要） |
+
+**TG-2.4: docs/einja/ 参照更新**（5-6ファイル）
+
+| ファイル | 更新内容 |
+|---------|---------|
+| `docs/einja/steering/development-workflow.md` | `/einja:spec-create` → `einja-issue-spec-create`、`/einja:task-exec` → `einja-task-exec`（多数） |
+| `docs/einja/steering/task-management.md` | spec-create、task-exec、update-docs-by-task-specs 参照更新 |
+| `docs/einja/steering/acceptance-criteria-and-qa-guide.md` | spec-create 参照更新 |
+| `docs/einja/instructions/task-execute.md` | spec-create、task-exec、エージェント名参照（多数） |
+| `docs/einja/instructions/issue-exec-workflow.md` | spec-create、task-exec 参照更新 |
+
+**TG-2.5: CLAUDE.md + README.md 更新**
+
+| ファイル | 更新箇所 | Before → After |
+|---------|---------|---------------|
+| `CLAUDE.md` | Skill/コマンドテーブル | `einja:spec-create` → `einja-issue-spec-create` |
+| `CLAUDE.md` | Skill/コマンドテーブル | `einja:task-exec` → `einja-task-exec` |
+| `CLAUDE.md` | Skill/コマンドテーブル | `einja:update-docs-by-task-specs` → `einja:update-docs-by-issue-specs` |
+| `CLAUDE.md` | サブエージェント一覧 | `spec-requirements-generator` → `requirements-generator` 等（短縮名） |
+| `README.md` | 行60 | `/einja:spec-create` → `einja-issue-spec-create`、`/einja:task-exec` → `einja-task-exec` |
+
+### Phase 3: 検証
+
+**TG-3.1: 参照整合性チェック**
+
+除外対象: `.bak/`, `.cursor/`, `.einja-sync-backups/`, `docs/specs/issues/`（履歴エビデンス）, `docs/plans/`（作業記録）
+
+```bash
+# 旧パス残存チェック
+grep -r "agents/einja/specs/" --include='*.md' --include='*.json' | grep -v '.bak/' | grep -v '.cursor/' | grep -v '.einja-sync-backups/' | grep -v 'docs/specs/' | grep -v 'docs/plans/'
+grep -r "agents/specs/" --include='*.md' --include='*.json' | grep -v '.bak/' | grep -v '.cursor/' | grep -v '.einja-sync-backups/' | grep -v 'docs/specs/' | grep -v 'docs/plans/'
+
+# 旧Skill名残存チェック
+grep -r "task-spec-generator\|task-spec-validator" --include='*.md' --include='*.json' | grep -v '.bak/' | grep -v 'docs/plans/'
+
+# 旧コマンド呼び出し残存チェック
+grep -r "/einja:spec-create\|/einja:task-exec" --include='*.md' | grep -v '.bak/' | grep -v '.cursor/' | grep -v 'docs/plans/'
+
+# 旧コマンド名残存チェック
+grep -r "update-docs-by-task-specs" --include='*.md' --include='*.json' | grep -v '.bak/' | grep -v 'docs/plans/'
+
+# 旧エージェント名残存チェック
+grep -r "spec-requirements-generator\|spec-design-generator\|spec-qa-generator\|spec-tasks-generator\|spec-tasks-validator" --include='*.md' --include='*.json' | grep -v '.bak/' | grep -v '.cursor/' | grep -v 'issue-specs/' | grep -v 'docs/specs/' | grep -v 'docs/plans/'
+```
+
+**TG-3.2: ビルド・テスト・クリーンアップ**
+- `pnpm prepush` 通過確認
+- `git diff --stat` で変更ファイル一覧確認
+- `.cursor/commands/` 配下の旧ファイル（`spec-create.md`, `task-exec.md`, `update-docs-by-task-specs.md`）を手動削除
+- `sync-cursor-commands` を実行してCursorルール再生成確認
+
+## リスク・注意事項
+
+1. **task-exec vs task-executer の混同**: `task-exec` は移行対象だが `task-executer` はエージェント名でリネーム対象外。置換時に `/einja:task-exec` や `task-exec コマンド` のみ対象とし、`task-executer` は除外する正規表現が必須
+2. **参照箇所の膨大さ**: 約50-55ファイル。Phase 3 の grep 検証でゼロ残存を確認してからコミット
+3. **`.einja-sync.json`**: `update-docs-by-task-specs.md` のみ登録あり（他のリネーム対象は未登録なので変更は1エントリのみ）
+4. **settings.json に customAgents セクションなし**: エージェント名はファイル名ベースで自動解決されるため、ファイルリネームのみで有効
+5. **エージェント name: フィールド**: 各エージェント定義の frontmatter `name:` を短縮名に更新必要
+6. **Cursor互換**: `sync-cursor-commands.md` の変換元パスを更新し、移行後に再生成を実行
+
+## 対象ファイル総数（確定）
+
+- 移動/リネーム: 約15ファイル
+- 参照更新: 約35-40ファイル
+- 合計: 約50-55ファイル

package/templates/default/docs/plans/federated-questing-kahan.md

@@ -0,0 +1,47 @@
+# Plan: README.md 古い情報の修正
+
+## Context
+
+README.md の徹底調査により、プロジェクトの実態と乖離した記述が **14件** 発見された。開発者向けセクションだけでなく、パッケージ利用者向けセクション（create-einja-app / @einja/dev-cli の使い方）にも複数の古い情報がある。
+
+## 修正対象ファイル
+
+- `README.md`
+
+## 修正一覧
+
+### A. パッケージ利用者向けセクション（行7-98）
+
+| # | 行 | 深刻度 | 問題 | 修正内容 |
+|---|-----|--------|------|---------|
+| A1 | 59-63 | 高 | `.claude/skills/` の説明が「コーディング規約、コンポーネント設計ガイド」 | 「ATDDワークフロー用スキル（タスク実行、QAテスト、コミット管理、コンフリクト解消等）」に修正 |
+| A2 | 63 | 高 | `.claude/hooks/` を「Git Hooks」と記載 | 「Claude Code Hooks（コード品質チェック、型検証、機密情報検出等）」に修正 |
+| A3 | 63 | 中 | `.claude/settings.json` を「MCPサーバー設定」と記載 | initで実際に作成されるのは `.mcp.json`。settings.jsonの記述を修正 |
+| A4 | 64-68 | 中 | `docs/einja/` の説明が不完全 | `instructions/`（操作手順書）と `example/`（サンプル仕様書）も追加 |
+| A5 | 68 | 低 | 「`package.json` にスクリプトが追加される」の記述が不完全 | `lint`, `format`, `typecheck`, `prepush` も追加されることを記載 |
+| A6 | 20 | 低 | 「Turborepo + Next.js 15 + Prisma のモノレポ構成」のみ | テンプレートには `apps/admin/` も含まれることを補足 |
+| A7 | 37 | 低 | create-einja-app のオプション `--yes` 記載 | CLIの `.option()` に `--yes` が未登録（バグ）。README側は現状維持し、CLI修正を別Issueで対応 |
+
+### B. パッケージ開発者向けセクション（行102-）
+
+| # | 行 | 深刻度 | 問題 | 修正内容 |
+|---|-----|--------|------|---------|
+| B1 | 110-142 | 高 | プロジェクト構成図に `apps/admin/` が未記載 | `apps/admin/` を追加 |
+| B2 | 110-142 | 高 | プロジェクト構成図に `packages/admin-ui/` が未記載 | `packages/admin-ui/` を追加 |
+| B3 | 277 | 高 | `PostgreSQL 15` と記載 | `PostgreSQL 16` に修正 |
+| B4 | 289 | 中 | Docker接続コマンドの DB名 `-d einja_management` | `-d main` に修正（POSTGRES_DB の実際の値） |
+| B5 | 133-137 | 軽微 | `server-core/src/` に `utils/` があると記載 | `core/`・`testing/` に修正 |
+| B6 | 314-319 | 軽微 | packagesセクションに `@repo/admin-ui` の説明なし | admin専用UIコンポーネントとして追加 |
+| B7 | 269 | 軽微 | ワークスペース固有コマンドの filter 例 `@repo/web` のみ | `@repo/admin` の例も追加 |
+
+## 実装手順
+
+1. サブエージェントに README.md の全修正を委託（1エージェント、全修正を一括）
+2. `git diff` で意図しない変更がないか確認
+3. `--yes` バグは別途対応（本タスクのスコープ外）
+
+## 検証
+
+- 修正後の README.md を `Read` で確認
+- 変更されたリンク先がすべて実在することを確認（調査済み）
+- `git diff --stat` で変更ファイルが README.md のみであることを確認

package/templates/default/docs/plans/fix-orphan-cleaner-review.md

@@ -0,0 +1,25 @@
+# Codexレビュー指摘修正: orphan-cleaner
+
+## 修正対象: High 2件
+
+### Fix 1: パストラバーサル脆弱性
+**箇所**: `packages/cli/src/commands/sync.ts` 孤児削除処理部分
+**修正**: 孤児ファイル削除前にパス検証関数を追加
+- `path.normalize` で正規化
+- `..` を含むパスを拒否
+- 絶対パスを拒否
+- 解決後パスがプロジェクトルート配下か検証
+- OrphanCleaner.detectOrphans() 内でも検証（検出段階でフィルタ）
+
+### Fix 2: 変更ファイル0件時に孤児削除に到達しない
+**箇所**: `packages/cli/src/commands/sync.ts:161-163`
+**修正**: 早期return条件に `orphanReport.hasOrphans` を追加
+- 孤児検出を早期returnの前に移動
+- `filesToProcess.length === 0 && !orphanReport.hasOrphans` の場合のみreturn
+- 変更なし＋孤児ありの場合はレポート表示/削除処理へ進む
+
+## 実装ステップ
+1. orphan-cleaner.ts にパス検証を追加（detectOrphans内）
+2. sync.ts の早期return修正 + 削除処理にもパス検証ガード追加
+3. orphan-cleaner.test.ts にパストラバーサルテスト追加
+4. typecheck + test 実行

package/templates/default/docs/plans/fix-sync-template-variables.md

@@ -0,0 +1,162 @@
+# 修正計画: create-einja-app sync コマンドの設計ギャップ修正
+
+## 問題一覧
+
+### 致命的 (Critical)
+
+| # | 問題 | 影響 |
+|---|------|------|
+| C-1 | sync にテンプレート変数置換がない | `@repo/`, `{{packageName}}` が未置換のままコピーされる |
+| C-2 | 環境ファイルの暗号化キー上書き | `.env.keys` 以外の `.env.*` が上書きされ秘密鍵が破壊 |
+| C-3 | Prismaスキーマの無条件上書き | apps/packages sync時にユーザーのDBモデルが消失 |
+
+### 重大 (High)
+
+| # | 問題 | 影響 |
+|---|------|------|
+| H-1 | package.json の scripts 完全上書き | ユーザーカスタムスクリプトが消失 |
+| H-2 | tsconfig.json の extends/paths 上書き | TypeScriptビルド設定が破壊 |
+| H-3 | dry-run がファイルリスト表示のみ | マージ結果や変数置換結果が確認不可 |
+| H-4 | バックアップが既存ファイルのみ | 新規追加ファイルがロールバックで残る |
+| H-5 | GitHub Actions YAML の無条件同期 | カスタマイズしたCIパイプラインが破壊 |
+
+### 中程度 (Medium)
+
+| # | 問題 | 影響 |
+|---|------|------|
+| M-1 | dev-cli / create-einja-app の管轄重複 | ユーザーが混乱 |
+| M-2 | マーカーの入れ子エラー処理不足 | マーカー破損時に警告なし |
+| M-3 | 冪等性の未保証 | sync 2回実行で結果が変わる可能性 |
+| M-4 | 個別ファイル保護の仕組みがない | conflictStrategy でしか保護できない |
+| M-5 | `.env.personal` の定義に `.env.keys` があるが実装で片方のみチェック | 保護漏れ |
+
+## 修正方針
+
+### Phase 1: 致命的問題の修正 (C-1, C-2, C-3)
+
+#### 1-1. ユーザーリポジトリから packageScope/projectName を検出
+
+sync は既存リポジトリに対して実行されるため、ユーザーの設定を自動検出する必要がある。
+
+**取得元の優先順位**:
+1. `.einja.json` (または `.einja-sync.json`) にメタデータとして保存されている場合
+2. ルート `package.json` の `name` フィールド（projectName）
+3. `apps/` or `packages/` 配下の `package.json` から `name` のスコープ部分を抽出
+4. 上記で取得できない場合は対話式プロンプトで入力
+
+**新規ファイル**: `src/utils/project-detector.ts`
+
+#### 1-2. sync プロセスにテンプレート変数置換を統合
+
+**方式**: テンプレートファイル読み込み後、マージ処理の**前**に `replacePlaceholders()` を適用
+
+- `template.ts` の `replacePlaceholders()` を export して共用化
+- `merger.ts` の `mergeAndWriteFile()` に templateVariables オプションを追加
+- `sync.ts` で検出した変数情報を `mergeAndWriteFile` に渡す
+
+**重要**: 置換はマージ前に行う。マージ後に行うと既存ファイルのユーザーカスタマイズまで誤って置換してしまう。
+
+#### 1-3. 置換漏れ検証
+
+sync 完了後に `@repo/` や `{{packageName}}` がターゲットファイルに残っていないか検証。
+
+**新規ファイル**: `src/utils/placeholder-validator.ts`
+
+#### 1-4. 環境ファイルの保護強化
+
+`ENV_FILE_PROTECTION` を拡張。dotenvx 暗号化済み値を含むファイルを保護対象に追加。
+
+```typescript
+const ENV_FILE_PROTECTION = {
+  protected: [
+    ".env.keys",       // 既存
+    ".env.personal",   // 既存
+    ".env.develop",    // 追加
+    ".env.local",      // 追加
+    ".env.production", // 追加
+    ".env.staging",    // 追加
+    ".env.preview",    // 追加
+  ],
+  allowed: [           // 同期許可
+    ".env.example",
+    ".env.personal.example",
+    ".envrc",
+  ],
+};
+```
+
+#### 1-5. Prismaスキーマ等の保護
+
+sync 対象から除外すべきファイルパターンを追加:
+- `**/prisma/schema.prisma` — DBモデルはユーザー固有
+- `**/prisma/migrations/**` — マイグレーション履歴
+- `pnpm-lock.yaml` — lockfile は sync すべきでない
+
+### Phase 2: 重大問題の修正 (H-1 ~ H-5)
+
+#### 2-1. package.json scripts の安全なマージ (H-1)
+
+現状: `{...existing, ...template}` でテンプレートが後勝ち。
+
+**方式**: scripts マージ時に、ユーザーが追加したキー（テンプレートに存在しないキー）を保持。テンプレート既存キーの上書き時は既にカスタマイズされている場合は警告。
+
+#### 2-2. `--all` 時のデフォルトスコープ制限 (H-1)
+
+`--all` 使用時も `packageJsonSections` のデフォルトを `["scripts", "engines"]` に限定。dependency 系は明示フラグ必要。
+
+#### 2-3. dry-run の改善 (H-3)
+
+dry-run 時にもマージ処理をシミュレーション実行し、実際のdiff（変更前後）を表示する。
+
+#### 2-4. バックアップの完全性 (H-4)
+
+sync 完了時に「追加されたファイル」のリストも記録し、ロールバック時に削除する。
+
+#### 2-5. GitHub Actions のマーカーベース保護 (H-5)
+
+`.github/workflows/*.yml` にマーカーベースマージを適用。managed セクション外のユーザーカスタマイズを保持。
+
+### Phase 3: テスト
+
+| テストファイル | 内容 |
+|---|---|
+| `tests/unit/utils/project-detector.test.ts` | **新規**: packageScope 自動検出 |
+| `tests/unit/utils/placeholder-validator.test.ts` | **新規**: 置換漏れ検出 |
+| `tests/unit/utils/merger.test.ts` | **追加**: templateVariables 付きマージ |
+| `tests/integration/sync-variables.test.ts` | **新規**: sync E2E（変数置換検証） |
+
+## 実装順序
+
+```
+Phase 1-1: project-detector 作成
+    ↓
+Phase 1-2: replacePlaceholders 共用化 + merger 統合
+    ↓
+Phase 1-3: placeholder-validator 作成
+    ↓ (並行可)
+Phase 1-4: env 保護強化  |  Phase 1-5: Prisma/lockfile 除外
+    ↓
+Phase 2 (並行可): scripts安全マージ | dry-run改善 | バックアップ完全性
+    ↓
+Phase 3: テスト作成
+```
+
+## 変更ファイルサマリ
+
+| ファイル | 操作 | 内容 |
+|---|---|---|
+| `src/utils/project-detector.ts` | **新規** | packageScope/projectName 検出 |
+| `src/utils/placeholder-validator.ts` | **新規** | 置換漏れ検出 |
+| `src/generators/template.ts` | 変更 | `replacePlaceholders()` を export |
+| `src/utils/merger.ts` | 変更 | templateVariables オプション追加 |
+| `src/commands/sync.ts` | 変更 | 変数検出・置換・検証ステップ追加 |
+| `src/generators/sync.ts` | 変更 | env保護リスト拡張、Prisma除外パターン追加 |
+| `src/types/index.ts` | 変更 | SyncMetadata に packageScope/projectName 追加 |
+
+## リスク
+
+| リスク | 軽減策 |
+|---|---|
+| `pnpm-lock.yaml` 内の `@repo/` 置換で lockfile 破壊 | sync 対象から除外 |
+| マージ前置換でマージ精度低下 | マーカーベースマージはテキスト比較なので影響なし |
+| 既存ユーザーの設定ファイルに packageScope がない | 自動検出 + 対話確認でフォールバック |

package/templates/default/docs/plans/flickering-pondering-hearth.md

@@ -0,0 +1,26 @@
+# Plan: task-exec.mdから冗長な「受け入れ条件の参照方法」セクションを削除
+
+## Context
+
+task-exec.md の「受け入れ条件の参照方法」セクション（247〜313行目）は以下の理由で冗長：
+- サブエージェント（task-executer/reviewer/qa）はtask-exec.mdを読まない
+- 同ファイル内のStep 2〜6で同じ内容が定義済み
+- Step 4のハイブリッド方式と矛盾する記述がある
+- 他ファイルからの参照は0件（Codexレビュー済み）
+
+## 変更内容
+
+### 対象ファイル
+- `.claude/commands/einja/task-exec.md`
+
+### 作業
+1. 246行目の `---` から 315行目の `---` の間にある「受け入れ条件の参照方法」セクション全体を削除
+   - 246行目: セパレータ `---`
+   - 247〜313行目: セクション本体
+   - 314行目: 空行
+   - 315行目: セパレータ `---`（「失敗時のリカバリーフロー」の前）
+   - ※ 「失敗時のリカバリーフロー」セクション前の `---` セパレータは維持
+
+## 検証
+- 削除後、前後のセクション（Phase 99フローと失敗時リカバリーフロー）が正しく繋がっていることを確認
+- `pnpm prepush` で lint/typecheck が通ることを確認