create-einja-app 0.3.2 → 0.3.4

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/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 が通ることを確認

package/templates/default/docs/plans/fluttering-snuggling-sprout.md

@@ -0,0 +1,172 @@
+# Plan: einja-skill-creator を公式版に追従改善 + skill-first hook修正
+
+## Context
+
+公式 Anthropic skill-creator（`anthropics/claude-plugins-official`）が更新されており、einja版は以前のバージョンをベースに日本語化・カスタマイズしたもの。
+公式版との差分を分析し、einja版に取り込むべき改善点を特定した。
+
+また、Plan mode時に `einja-skill-first` の評価リマインダーを自動注入する `plan-mode-skill-loader.sh` hookが正常に機能していないことが判明。hookの修正も本Planに含める。
+
+---
+
+## 差分分析サマリー
+
+### 優先度: 高（機能・正確性に影響）
+
+| # | 差分 | 影響 |
+|---|------|------|
+| 1 | **run_loop.py のシグネチャ不一致** — `holdout`が公式=float(割合) vs einja=int(件数)、第一引数が`eval_set:list` vs `eval_set_path:str` | SKILL.mdの手順通りに`--holdout 0.4`で実行すると動作しない |
+| 2 | **run_loop.py のtrain/test順次実行** — 公式版は1バッチで並列実行してから分割、einja版は順次 | 評価実行時間が約2倍 |
+| 3 | **run_loop.py のblinded_history欠落** — 公式版はimprove時にtest結果を隠蔽してオーバーフィット防止 | einja版はtestスコアが改善プロンプトに漏れてオーバーフィットリスクあり |
+| 4 | **aggregate_benchmark.py が完全別機能** — 公式版はschemas.md準拠のbenchmark.json生成、einja版は複数run_loop出力の横断比較 | Benchmarkモード（viewer.htmlのBenchmarkタブ）が動作しない |
+| 5 | **SKILL.md: grading.jsonフィールド名警告の欠落** — `text`/`passed`/`evidence`必須、`name`/`met`/`details`禁止 | viewerがフィールド不一致で正しく表示されないリスク |
+
+### 優先度: 中（品質・UXに影響）
+
+| # | 差分 | 影響 |
+|---|------|------|
+| 6 | **SKILL.md: eval queryのGood/Bad具体例が欠落** — トリガー評価クエリの品質基準 | 低品質なevalクエリが生成されdescription最適化の精度低下 |
+| 7 | **SKILL.md: タイミングデータ即時処理の警告欠落** — 「通知は1回限り、バッチ不可」 | timing.jsonの保存漏れリスク |
+| 8 | **SKILL.md: コアループ再掲+TodoList指示の欠落** — 末尾のフロー要約とCowork向けTodoList指示 | 作業手順の抜け漏れリスク（特にCowork環境） |
+| 9 | **SKILL.md: Claude.ai制限の文脈説明欠落** — ブラインドテスト不可の注意 | ユーザーが結果の制限を理解できない |
+| 10 | **run_loop.py: ブラウザ自動オープン+results_dir保存機能なし** | ライブモニタリング・出力管理の利便性低下 |
+| 11 | **generate_report.py: stdin対応なし** — 公式版は`--input -`でstdinから読める | パイプライン連携の柔軟性が低い |
+
+### 優先度: 低（軽微・好みの問題）
+
+| # | 差分 | 影響 |
+|---|------|------|
+| 12 | **SKILL.md: feedback.jsonのスキーマ例欠落** | ユーザーがフィードバック形式を理解しにくい |
+| 13 | **SKILL.md: Coworkフィードバックアクセス権限の注意欠落** | Coworkユーザーがfeedback.json読み込みで詰まる |
+| 14 | **generate_report.py: UIデザインの差異** — 公式版はtest/train色分けが明確 | 視認性の差（機能的には同等） |
+
+### einja版の独自強み（維持すべき）
+
+| 要素 | 内容 |
+|------|------|
+| `init_skill.py` | Skill初期化スクリプト（公式版にない） |
+| 参考ドキュメント記録規約 | 設計根拠追跡のHTMLコメント記録 |
+| `@einja:excluded` / `@einja:project-private` | テンプレート除外マーカー |
+| `quick_validate.py` のeinja固有チェック | プレフィックス推奨、行数チェック |
+| import フォールバック | `run_eval.py`のtry/except import |
+| description日英併記 | 日本語ユーザー向けトリガー精度向上 |
+
+---
+
+## 推奨改善アプローチ
+
+### Phase 0: plan-mode-skill-loader.sh hook修正
+
+**対象ファイル**: `.claude/hooks/einja/plan-mode-skill-loader.sh`
+
+**現状**: hook自体は正常終了（exit 0）するが、`additionalContext` のリマインダーがAIコンテキストに到達していない。会話冒頭で `UserPromptSubmit hook success: Success` のみ表示され、リマインダーテキストが注入されていない。
+
+**調査・修正方針**:
+
+1. **デバッグ確認**: hookにデバッグ出力を追加し、`permission_mode` の実際の値を確認
+   - `echo "DEBUG: permission_mode=$permission_mode" >&2` を追加して値を特定
+2. **原因候補の検証**:
+   - `permission_mode` が `"plan"` 以外の値（例: `"default"` でPlan modeでも変わらない等）
+   - `additionalContext` の出力が "discrete"（背景的）すぎて実効性がない
+   - jqの出力がパイプで消失している
+3. **修正案**:
+   - **案A**: `additionalContext` を `hookSpecificOutput` でネストして明示的に注入
+   - **案B**: Plain text stdoutに切り替えてトランスクリプトに直接表示
+   - **案C**: `permission_mode` の条件を緩和/修正（値が異なる場合）
+4. **検証**: Plan modeで新セッションを開始し、リマインダーが表示されることを確認
+
+### Phase 1: スクリプト互換性修正（高優先度 #1-4）
+
+**注意**: Phase 1完了後、SKILL.mdのコマンド例が一時的に不整合になる。Phase 2で連動更新する。
+
+#### 1-a. run_loop.py を公式版ベースに再構築
+   - `holdout` を float 割合に統一（公式: `0.4` = 40%）
+   - train/test 並列バッチ実行に変更（1バッチで並列→分割）
+   - blinded_history を追加（test結果を隠蔽してオーバーフィット防止）
+   - ブラウザ自動オープン（`webbrowser.open`）・`results_dir` 保存を追加
+   - 終了条件を公式版に統一（trainのみ全パスで終了、testは過学習チェック用）
+   - **einja独自機能の保持判断**:
+     - `--improve-model`（評価/改善モデル分離）→ **保持**（公式版より柔軟）
+     - `--seed`（再現性確保）→ **保持**（デバッグに有用）
+     - import フォールバック・日本語コメント → **保持**
+
+#### 1-b. improve_description.py の互換性確認・修正
+   - blinded_history導入に伴うシグネチャ変更の要否を確認
+   - 公式版: `/tmp/official-sc-scripts-improve_description.py`
+   - einja版: `.claude/skills/einja-skill-creator/scripts/improve_description.py`
+   - 差分があればblinded_history対応を追加
+
+#### 1-c. aggregate_benchmark.py を公式版に差し替え
+   - 既存のeinja版横断比較機能は `compare_runs.py` に別名保存
+   - schemas.md準拠のbenchmark.json生成を復元（viewer.htmlのBenchmarkタブが動作するように）
+   - **現状の不整合**: einja版SKILL.mdに記載のコマンド `python -m scripts.aggregate_benchmark <workspace>/iteration-N --skill-name <name>` が既にeinja版スクリプトでは動作しない状態。公式版差し替えでこの不整合が解消される
+
+### Phase 2: SKILL.md内容補完（高・中優先度 #5-9） ※Phase 1との連動更新含む
+
+#### 2-a. Phase 1連動のコマンド例更新
+   - run_loopのコマンド例を公式版シグネチャに合わせて更新
+   - `--holdout 0.4` 引数の追記
+   - `--improve-model`（einja独自）の説明追記
+   - aggregate_benchmarkのコマンド例は既に正しい（公式版差し替えで整合）
+
+#### 2-b. 公式版の重要な詳細を追記
+   - grading.jsonフィールド名警告（#5）— `text`/`passed`/`evidence`必須、誤フィールド禁止
+   - eval queryのGood/Bad具体例（#6）— 公式版の具体例を日本語化
+   - タイミングデータ即時処理警告（#7）— 「通知は1回限り、バッチ不可」
+   - コアループ再掲+TodoList指示（#8）— 末尾にフロー要約を追加
+   - Claude.ai制限の文脈説明（#9）— ブラインドテスト不可の注意
+   - feedback.jsonスキーマ例（#12）
+   - Coworkアクセス権限注意（#13）
+
+#### 2-c. compare_runs.py（別名保存した横断比較）の説明追加（任意）
+
+### Phase 3: UX改善（中・低優先度 #10-14）
+
+4. **generate_report.py のstdin対応追加**（`--input -`）
+5. **generate_report.py のtest/train色分け改善**（任意）
+6. **回帰テスト**: `init_skill.py`・`quick_validate.py` が引き続き動作することを確認
+
+---
+
+## 対象ファイル
+
+| ファイル | 変更内容 |
+|---------|---------|
+| `.claude/hooks/einja/plan-mode-skill-loader.sh` | デバッグ・修正（リマインダー注入が機能するように） |
+| `.claude/skills/einja-skill-creator/SKILL.md` | 公式版の詳細指示を追記 + コマンド例更新 |
+| `.claude/skills/einja-skill-creator/scripts/run_loop.py` | 公式版ベースに再構築（einja独自機能保持） |
+| `.claude/skills/einja-skill-creator/scripts/improve_description.py` | blinded_history対応（要否確認後） |
+| `.claude/skills/einja-skill-creator/scripts/aggregate_benchmark.py` | 公式版に差し替え（既存は `compare_runs.py` に別名保存） |
+| `.claude/skills/einja-skill-creator/scripts/compare_runs.py` | aggregate_benchmark.pyの旧einja版を別名保存 |
+| `.claude/skills/einja-skill-creator/scripts/generate_report.py` | stdin対応追加 |
+
+## 公式版ファイル（参照用）
+
+`/tmp/` にダウンロード済み:
+- `/tmp/official-skill-creator-SKILL.md` — 公式SKILL.md（479行）
+- `/tmp/official-sc-scripts-run_loop.py` — 公式run_loop.py
+- `/tmp/official-sc-scripts-aggregate_benchmark.py` — 公式aggregate_benchmark.py
+- `/tmp/official-sc-scripts-generate_report.py` — 公式generate_report.py
+- その他 `/tmp/official-sc-*` — 公式版の全ファイル
+
+## 検証方法
+
+### Phase 0: hook修正
+- Plan modeで新セッションを開始し、`<system-reminder>` にskill-firstリマインダーが表示されることを確認
+- Plan mode以外ではリマインダーが注入されないことを確認
+
+### Phase 1: スクリプト互換性
+- `python -m scripts.run_loop --help` で引数が公式版と一致（`--holdout` がfloat、`--results-dir` 等が存在）
+- `python -m scripts.aggregate_benchmark --help` で引数が公式版と一致（ディレクトリ引数）
+- `python -m scripts.improve_description --help` でblinded_history対応を確認
+- 小規模実行テスト: 2-3クエリのeval setで `run_loop` を実際に実行し、benchmark.json生成→viewer.htmlのBenchmarkタブ表示まで確認
+- `compare_runs.py` が旧einja版の横断比較機能として動作することを確認
+
+### Phase 2: SKILL.md補完
+- SKILL.md の公式版との差分レビュー（grading.jsonフィールド警告、eval query Good/Bad例、コアループ再掲等が反映されていることを目視確認）
+- SKILL.md のコマンド例が更新後のスクリプトシグネチャと整合していることを確認
+
+### Phase 3: UX + 回帰テスト
+- `python -m scripts.quick_validate` でスキーマ検証パス
+- `init_skill.py` が引き続き動作することを確認
+- `generate_report.py` のstdin対応テスト

package/templates/default/docs/plans/generic-sleeping-snowglobe-agent-a41d8da.md

@@ -0,0 +1,179 @@
+# 計画レビュー結果: generic-sleeping-snowglobe
+
+## レビュー完了日時
+2026-03-04
+
+## 総評
+⚠️ PARTIAL - 3件の重要な問題を検出。修正後に実装可能。
+
+## 問題点と修正指示
+
+### 問題1: Step 2 に Manager worktree 作成が記述されていない【最重要】
+
+**箇所:** `.claude/commands/einja/issue-exec.md` L124-137
+
+**現状:**
+```markdown
+### Step 2: ブランチ & worktree 作成
+1. Issue ブランチ作成: `issue/{issue番号}`（base ブランチから）
+2. 各 Phase のブランチ作成: `issue/{issue番号}-phase{N}`（issue ブランチから）
+3. git worktree 作成:
+   mkdir -p ~/.einja/worktrees/issue-{N}/
+   git worktree add ~/.einja/worktrees/issue-{N}/phase{M} issue/{N}-phase{M}
+```
+
+**修正後:**
+```markdown
+### Step 2: ブランチ & worktree 作成
+1. Issue ブランチ作成: `issue/{issue番号}`（base ブランチから）
+2. Manager worktree 作成（メインリポジトリから）:
+   ```bash
+   mkdir -p ~/.einja/worktrees/issue-{N}/
+   git worktree add ~/.einja/worktrees/issue-{N}/manager issue/{N}
+   git push -u origin issue/{N}
+   ```
+3. **以降の操作は全て Manager worktree 内から実行する**（cwd: `~/.einja/worktrees/issue-{N}/manager`）
+4. 各 Phase のブランチ作成（Manager worktree から）: `issue/{issue番号}-phase{N}`（issue ブランチから）
+5. Phase worktree 作成（Manager worktree から）:
+   ```bash
+   git worktree add ~/.einja/worktrees/issue-{N}/phase{M} issue/{N}-phase{M}
+   git push -u origin issue/{N}-phase{M}
+   ```
+```
+
+**理由:** 計画の中核である「Manager を worktree 化」が実装記述に反映されていない
+
+---
+
+### 問題2: Step 4 tmux セッション起動ディレクトリ未指定
+
+**箇所:** `.claude/commands/einja/issue-exec.md` L166-168
+
+**現状:**
+```bash
+tmux new-session -d -s einja-{issue番号} -n manager
+```
+
+**修正後:**
+```bash
+tmux new-session -d -s einja-{issue番号} -n manager -c ~/.einja/worktrees/issue-{N}/manager
+```
+
+**理由:** Manager が worktree 内で動作するよう cwd を明示する必要がある
+
+---
+
+### 問題3: worktree 物理パス構成図に manager/ が欠落
+
+**箇所:** `.claude/commands/einja/issue-exec.md` L266-270
+
+**現状:**
+```markdown
+## worktree 物理パス
+```
+~/.einja/worktrees/issue-{N}/
+├── phase{M}/                     ← Director cwd
+├── task-{X.Y}/                   ← Worker cwd
+```
+```
+
+**修正後:**
+```markdown
+## worktree 物理パス
+```
+~/.einja/worktrees/issue-{N}/
+├── manager/                      ← Manager cwd（NEW）
+├── phase{M}/                     ← Director cwd
+├── task-{X.Y}/                   ← Worker cwd
+```
+```
+
+**理由:** 計画で明記された構成図との整合性
+
+---
+
+## 改善提案
+
+### 提案1: Step 0-3 セッション復元に Manager worktree 再作成を追記
+
+**箇所:** `.claude/commands/einja/issue-exec.md` L112-114
+
+**現状:**
+```markdown
+#### 3. セッション復元
+- `--resume` フラグがある場合、`~/.einja/sessions/issue-{N}/session.json` からセッション状態を復元
+  - 未完了のPhaseのDirectorを再起動する
+```
+
+**追記案:**
+```markdown
+#### 3. セッション復元
+- `--resume` フラグがある場合、`~/.einja/sessions/issue-{N}/session.json` からセッション状態を復元
+  - Manager worktree の存在確認: `git worktree list | grep issue-{N}/manager`
+    - 存在しない場合は再作成: `git worktree add ~/.einja/worktrees/issue-{N}/manager issue/{N}`
+  - 未完了のPhaseのDirectorを再起動する
+```
+
+**理由:** 計画で明記されているが、実装記述に含まれていない
+
+---
+
+### 提案2: セッションクリーンアップに Manager worktree 削除を追加
+
+**箇所:** `.claude/commands/einja/issue-exec.md` L390-395
+
+**現状:**
+```markdown
+## セッションクリーンアップ
+
+Issue完了時に以下を自動削除:
+- `~/.einja/sessions/issue-{N}/` （セッションファイル）
+- `~/.einja/worktrees/issue-{N}/` （worktree。事前に `git worktree remove` を実行）
+- ローカルブランチのクリーンアップ（task/*, issue/*-phase*）
+```
+
+**追記案:**
+```markdown
+## セッションクリーンアップ
+
+Issue完了時に以下を自動削除:
+- `~/.einja/sessions/issue-{N}/` （セッションファイル）
+- `~/.einja/worktrees/issue-{N}/` （worktree。事前に `git worktree remove` を各ディレクトリに対して実行）
+  - `git worktree remove ~/.einja/worktrees/issue-{N}/manager`
+  - `git worktree remove ~/.einja/worktrees/issue-{N}/phase{M}`
+  - `git worktree remove ~/.einja/worktrees/issue-{N}/task-{X.Y}`
+- ローカルブランチのクリーンアップ（task/*, issue/*-phase*, issue/{N}）
+```
+
+**理由:** Manager worktree も削除対象に含める必要がある
+
+---
+
+## 検証済み項目
+
+### ✅ 技術的正確性
+- worktree内から `git worktree add` / `git branch` / `git push` が動作することを確認済み（計画に記載あり）
+
+### ✅ 複数Issue同時実行の安全性
+- 各 Manager が独立した worktree で動作するため race condition は発生しない
+- ブランチ名も `issue/{N}` で分離されており衝突しない
+
+### ✅ 後方互換性
+- Director/Worker の起動方法は変更なし
+- ステータスファイル構造は絶対パスで管理されており影響なし
+
+### ✅ その他の変更なし箇所
+- Director/Worker 起動方法
+- ステータスファイル構造
+- `gh pr create` コマンド
+- `einja-team-exec` Skill
+- `task-exec` コマンド
+
+---
+
+## 次のステップ
+
+1. 上記3件の問題を修正する
+2. 改善提案2件を検討・適用する
+3. 修正後、issue-exec.md の全体整合性を再確認する
+4. `presets/default/` へのビルド反映は自動（CLAUDE.md記載のとおり）