create-einja-app 0.3.1 → 0.3.2

package/templates/default/docs/plans/sprightly-leaping-manatee.md

@@ -0,0 +1,224 @@
+# task-exec: タスク単位並列実行 + TodoWrite進捗管理
+
+## Context
+
+現在の `task-exec` コマンドはタスクグループ（X.Y）全体を1つの `task-executer` に丸投げし、内部で順次実装している。この方式では：
+- 依存関係のない独立タスクも直列実行されるため非効率
+- task-executerが自分でIssue/spec読み込みを行うため、並列時にN回重複読み込みが発生
+- task-executerがIssue構造に依存しており、汎用性が低い
+
+**目的**:
+1. task-exec（親）がIssue解析・AC抽出・specパス特定を一括で行い、ハイブリッド方式でタスクごとに渡す
+2. TodoWriteで進捗管理しつつ、依存関係に基づいた並列実行を実現
+3. task-executerをIssue非依存の汎用実装エージェントにする
+
+**情報渡し方式: ハイブリッド**
+- AC（受け入れ基準）→ 親が抽出してpromptに直接埋め込む（小さい・重要・~100トークン/AC）
+- 設計（design.md）→ ファイルパス + セクション名のみ渡す（大きい・executerが自分でRead）
+- フォールバック: ファイルパスも併記し、executerが追加情報を自由に読める
+
+## 新フロー
+
+```
+task-exec（親）
+  1. Issueフェッチ → タスクグループ内タスク(X.Y.Z)を解析
+  2. spec存在チェック + requirements.mdからAC抽出 + design.mdパス特定
+  3. TaskCreate で各タスクを登録（依存関係 + AC + 設計参照パス付き）
+  4. 依存関係ベース並列実行ループ:
+      - ブロックなしタスク → 並列で task-executer 起動
+        （各executerに「AC直接埋込 + 設計パス参照 + タスク指示」を渡す）
+      - 完了後、新たにブロック解除されたタスク → 次バッチで並列起動
+      - 全タスク完了まで繰り返し
+  5. task-reviewer（グループ全体で1回）
+  6. task-qa（グループ全体で1回）
+  7. einja-task-commit
+```
+
+## 変更ファイル
+
+### 1. `.claude/commands/einja/task-exec.md`（主要変更）
+
+#### allowed-tools に追加
+- `Skill` ツールを追加（必要時のspec-context-loader呼び出し用）
+
+#### 処理フローの書き換え
+
+##### Step 0: 入力解析（現行通り）
+- Issue番号とタスクグループ番号を$ARGUMENTSから解析
+
+##### Step 1: Issueフェッチ + タスク解析（新規）
+
+1. `gh issue view` でIssue本文を取得
+2. 指定タスクグループ（X.Y）配下のタスク（X.Y.Z）をパース
+3. 各タスクのメタデータを抽出:
+   - タスク名
+   - 要件（Story番号）
+   - 依存関係（なし / X.Y.Z形式）
+   - 完了条件
+   - 対応設計セクション名
+   - シナリオテスト
+
+##### Step 2: spec読み込み + AC抽出（新規 - task-executerから移管）
+
+1. specディレクトリを探索: `docs/specs/issues/*/issue{N}-*/`
+2. 存在チェック:
+   - 完全なspec → 次へ
+   - 部分的spec → エラー終了
+   - specなし → general-context-loader Skill呼び出し
+3. requirements.mdを読み込み、各タスクのメタデータ（`**要件**: Story X`）に基づいてACを抽出
+   - ACはGiven/When/Then形式で小さい（~50-100トークン/AC）ので直接保持
+4. design.mdは**パスのみ特定**（内容は読み込まない）
+   - 各タスクの`**対応設計**: design.md「セクション名」`からセクション名を記録
+
+##### Step 3: TodoWrite登録（新規）
+
+各タスクを `TaskCreate` で登録:
+```
+TaskCreate:
+  subject: "X.Y.Z タスク名"
+  description: |
+    ## 受け入れ基準（抽出済み）
+    - AC1.2: Given: DBスキーマ定義済 When: マイグレーション実行 Then: テーブル作成
+    - AC1.3: Given: アプリ起動 When: DB接続 Then: 正常接続
+    ## 設計参照
+    {specパス}/design.md → 「3. DB設計」セクション
+    ## 完了条件
+    DBに接続できること（AC1.2〜AC1.3を満たす）
+    ## 参考（追加情報が必要な場合）
+    - requirements.md: {specパス}/requirements.md
+    - design.md: {specパス}/design.md
+  activeForm: "タスクX.Y.Zを実装中"
+```
+
+依存関係を `TaskUpdate` の `addBlockedBy` で設定:
+- `**依存関係**: 1.1.1` → 対応するTodoタスクIDを `addBlockedBy` に設定
+- `**依存関係**: なし` → ブロックなし
+- `**依存関係**: 1.1` (タスクグループ依存) → グループ外依存のため事前に完了済みと想定
+
+##### Step 4: 依存関係ベース並列実行ループ（新規）
+
+```
+while (未完了タスクが存在):
+  1. TaskList で未完了タスクを確認
+  2. blockedBy が空かつ pending のタスクを収集
+  3. 収集したタスクを TaskUpdate で in_progress に設定
+  4. Task ツールで複数の task-executer を並列起動:
+     - 各 task-executer のpromptに以下を含める（ハイブリッド方式）:
+       a. タスクID + タスク名 + 実装指示（Issueから抽出したサブタスク内容）
+       b. AC（受け入れ基準）→ 直接埋め込み（親が抽出済み）
+       c. 設計 → design.mdパス + セクション名（executerが自分でRead）
+       d. 完了条件
+       e. フォールバック用specファイルパス（追加情報が必要な場合）
+     - run_in_background: true で非同期起動（2タスク以上の場合）
+  5. 各エージェントの完了を待機
+  6. 完了したタスクを TaskUpdate で completed に設定
+  7. ループ先頭に戻る
+```
+
+##### Step 5-7: レビュー・QA・コミット（現行と同様）
+- task-reviewer: グループ全体で1回
+- task-qa: グループ全体で1回
+- einja-task-commit: QA合格後に実行
+
+##### フロー図
+
+```
+┌─────────────────────────────────────────────────────────┐
+│                    品質保証ループ                        │
+│                                                         │
+│  Issueパース → specパス特定 → TodoWrite登録            │
+│       ↓                                                 │
+│  依存関係ベース並列実行:                                │
+│       task-executer × N（独立タスク並列）               │
+│       ↓ 全タスク完了                                    │
+│  task-reviewer → task-qa                                │
+│       ↑              │                                  │
+│       └──────────────┘                                  │
+│          （MAJOR/テスト失敗時は該当タスクのみ再実行）    │
+│                                                         │
+│  QA合格後 ↓                                             │
+│  einja-task-commit Skill                                │
+└─────────────────────────────────────────────────────────┘
+```
+
+### 2. `.claude/agents/einja/task/task-executer.md`（中規模変更）
+
+#### A. Issue/spec自動読み込み機能の削除
+
+以下を削除:
+- `skills:` セクションから `spec-context-loader`, `general-context-loader` を削除
+- セクション「1.0 spec 存在チェック」を削除
+- セクション「1.2 コンテキスト収集モードの決定」（1.2A, 1.2B, 1.2C）を削除
+- spec関連エラー処理を削除
+
+#### B. 入力形式の変更
+
+新しい入力形式をセクション冒頭に追記:
+
+```markdown
+## 入力（ハイブリッド方式）
+
+task-exec（親）からpromptで以下の情報を受け取ります:
+- **タスクID**: X.Y.Z形式
+- **タスク名・実装指示**: Issueから抽出した具体的な作業内容
+- **AC（直接埋込）**: Given/When/Then形式の受け入れ基準テキスト（親が抽出済み）
+- **設計参照**: design.mdのファイルパス + セクション名（自分でReadする）
+- **完了条件**: ACを含む具体的な完了条件
+- **フォールバックパス**: requirements.md / design.md のフルパス（追加情報が必要な場合）
+
+ACはpromptに直接含まれるので即座に参照可能。
+設計情報は指定されたパス+セクションをRead toolで読み込む。
+```
+
+#### C. 実行フローの簡素化
+
+現行のセクション1（コンテキスト収集）を以下に置換:
+```markdown
+### 1. コンテキスト確認
+1.1 promptに埋め込まれたAC（受け入れ基準）を確認
+1.2 設計参照パス + セクション名に基づき、design.mdの該当セクションをReadで読み込む
+1.3 実装種別に応じたドキュメント参照（現行の1.3と同等）
+1.4 既存実装の分析（Serena MCPで関連コード調査 - 現行の1.1と同等）
+```
+
+#### D. 並列実行時の注意事項（新規追加）
+
+```markdown
+#### 4.0 並列実行モードの注意事項
+
+task-execから個別タスク（X.Y.Z）として呼び出された場合:
+- 指定されたタスクのみを実装する（他のタスクには触れない）
+- git操作はCLAUDE.mdのサブエージェント安全ルールに従う
+- コミットは行わない（task-exec完了後にまとめて実行）
+```
+
+#### E. 修正記録パスの調整
+
+```
+- **タスクグループ単位実行**: `modifications/task-{X}-{Y}.md`（従来互換）
+- **個別タスク実行**: `modifications/task-{X}-{Y}-{Z}.md`
+```
+
+## 変更しないファイル
+
+- `task-reviewer.md` - グループ全体レビューは現行通り
+- `task-qa.md` - グループ全体QAは現行通り
+- `task-management.md` - read-only（マネージドディレクトリ）
+- `CLAUDE.md` - git安全ルールは既に十分
+
+## リスクと対策
+
+| リスク | 対策 |
+|--------|------|
+| 並列task-executerのファイル衝突 | 設計書のセクション分割から変更対象を推定。重複懸念時は直列化 |
+| TodoWrite IDと依存関係のマッピング | タスク番号→TodoID のマッピングテーブルを保持 |
+| 失敗タスクのリカバリー | 失敗タスクとそれにブロックされるタスクを特定し再実行 |
+| AC抽出精度 | ACはGiven/When/Then定型なので抽出は機械的。フォールバックパスも併記 |
+
+## 検証方法
+
+1. **構文確認**: 変更後のtask-exec.md、task-executer.mdをReadで確認
+2. **実際のIssueでテスト**: 既存のGitHub Issue（タスクグループ付き）に対して `/einja:task-exec` を実行
+3. **TodoWrite動作確認**: TaskList でタスクが正しく登録・依存関係設定されていることを確認
+4. **並列実行確認**: 独立タスクが実際に並列dispatchされることを確認
+5. **QAループ確認**: 全タスク完了後にreviewer→qaが正常に動作することを確認

package/templates/default/docs/plans/stateful-wishing-lerdorf.md

@@ -0,0 +1,161 @@
+# Plan: einja-skill-advisor Skill 作成
+
+## Context
+
+タスク着手前に「Skillを先に作るべきか」を評価し、必要なら Skill 作成を TODO の先頭に積むメタ Skill を作成する。Plan mode 中でも評価・提案フェーズが動作し、Skill 作成自体は Plan 承認後に `einja-skill-creator` へ委譲する設計。
+
+## 作成するファイル
+
+| ファイル | 内容 |
+|---------|------|
+| `.claude/skills/einja-skill-advisor/SKILL.md` | Skill 本体（新規作成） |
+
+## 修正するファイル
+
+| ファイル | 変更内容 |
+|---------|---------|
+| `CLAUDE.md` | 必須フローに自動起動ステップ追加 + Skillテーブル追記 + キーワードトリガー追記 |
+| `.claude/commands/einja/spec-create.md` | Phase 0 に skill-advisor 自動評価ステップ追加 |
+
+## Skill 設計概要
+
+### 名前・トリガー
+
+- **Skill名**: `einja-skill-advisor`
+- **allowed-tools**: `Read`, `Grep`, `Glob`（Plan mode 制約に完全適合）
+- **起動方式**: 以下の3系統（いずれもユーザーが意識せず Claude が自動判断）
+  1. **Plan mode 進入時**: CLAUDE.md の必須フロー Step 1 で自動実行。ユーザーが自由形式でタスクを依頼→Plan mode に入った時点で評価
+  2. **spec-create 実行時**: `/einja:spec-create` の Phase 0（前提確認）で自動実行。新機能の仕様策定前に Skill の必要性を評価
+  3. **明示起動（補助）**: キーワード「Skill作るべき？」「Skill-first」等でも直接呼び出し可能
+- **設計意図**: 既存のドキュメント・Skill・サブエージェントがない領域のタスクで特に効果を発揮。「未整備の領域で場当たり的に作業する前に、まず Skill を作って品質を安定させる」判断を Claude が自動で行う
+
+### フロー（4ステップ）
+
+```
+ステップ1: 作業パターン分析
+  - 作業カテゴリ特定（FE/BE/インフラ/ドキュメント/リファクタ等）
+  - 反復性評価（今後も繰り返すか、memory/patterns.md を参照）
+  - 複雑度評価（手順数・判断分岐数・参照ドキュメント数）
+
+ステップ2: 既存Skillギャップ分析
+  - .claude/skills/einja-*/SKILL.md を Glob で動的取得
+  - 各Skillの name/description を読み取り、カバレッジを3段階判定
+    - 完全カバー → Skill作成不要
+    - 部分カバー → 既存Skill拡張を検討
+    - カバー外 → 新規Skill作成を検討
+
+ステップ3: ROI評価（スコアリング）
+  コスト側: 作成時間 + 複雑度 + テスト必要度（各1-3点）
+  価値側: 再利用頻度 + 品質安定化 + 時間節約 + チーム共有（各1-3点）
+  判定: 価値合計 - コスト合計 >= 2 → 推奨
+
+ステップ4: 構造化出力
+  - 判定結果（🟢推奨 / 🟡拡張推奨 / ⚪不要）
+  - Skill概要仕様（推奨時: 名前・目的・主要フロー・推定時間）
+  - 推奨ワークフロー
+```
+
+### スキップ基準（即座に「不要」判定）
+
+- 単発の小規模修正（バグ修正、typo、設定値変更）
+- CLAUDE.md のキーワードトリガーに既に一致するタスク
+- 作業指示が具体的かつ限定的（「ファイルXのY行をZ変更」等）
+
+### Plan mode 対応
+
+```
+Plan mode 内で skill-advisor が行うこと:
+  ✅ 既存Skill一覧を Glob + Read で取得
+  ✅ memory/patterns.md を参照
+  ✅ ROI評価ロジック実行（計算のみ）
+  ✅ 構造化された評価結果を返却
+
+Plan mode 内で行わないこと:
+  ❌ ファイル作成・編集
+  ❌ einja-skill-creator の呼び出し
+  ❌ Bash コマンド実行
+
+親エージェントの責務（Plan mode 内）:
+  - skill-advisor の結果を受け取り AskUserQuestion で提案
+  - 承認されたら計画ファイルの TODO-0 に Skill 作成を記載
+
+Plan mode 解除後:
+  - TODO-0: einja-skill-creator で Skill 作成
+  - TODO-1〜: 作成した Skill で本作業実行
+```
+
+### einja-skill-creator との責務分離
+
+| 責務 | skill-advisor | skill-creator |
+|------|:---:|:---:|
+| ギャップ分析・ROI評価 | ○ | - |
+| Skill仕様ドラフト（概要） | ○ | - |
+| SKILL.md 作成 | - | ○ |
+| テスト・eval | - | ○ |
+
+skill-advisor の出力（Skill概要仕様）が skill-creator の入力として機能する設計。
+
+## CLAUDE.md 変更内容
+
+### 1. 必須フローへの自動起動の組み込み（最重要）
+
+現行の必須フロー:
+```
+1. 問題・要件を調査・分析する
+2. 修正計画を docs/plans/ に作成し提示する
+3. ユーザーの明示的な承認を得る
+4. 承認後、実装を開始する
+```
+
+変更後:
+```
+1. 問題・要件を調査・分析する
+2. 修正計画を docs/plans/ に作成する
+3. einja-skill-advisor で「Skill を先に作るべきか」を自動評価する
+   - 計画の内容・スコープを見て判断（全体像が見えた状態で評価）
+   - 推奨判定 → AskUserQuestion でユーザーに提案
+   - 承認 → 計画の TODO-0 に Skill 作成を追加
+   - 不要判定 → そのまま次へ進む
+   ※ スキップ基準に該当する場合は評価自体を省略
+4. 計画をユーザーに提示し、明示的な承認を得る
+5. 承認後、実装を開始する（TODO-0 があれば Skill 作成から）
+```
+
+**ポイント**: 計画を作って全体像が見えてから Skill の必要性を判断する。ユーザーが Skill の存在を知らなくても、Claude Code 側から自動的に「先に Skill を作ったほうが効率的です」と提案する。
+
+### 2. spec-create.md への組み込み
+
+spec-create の Phase 0（前提確認）に追加:
+```
+Phase 0: 前提確認
+  ├─ TDD適用判定
+  ├─ 要件明確さ確認
+  ├─ ブランチ選択
+  └─ 【追加】einja-skill-advisor で Skill 作成必要性を評価
+       → 推奨時はユーザーに提案、承認なら先に Skill 作成
+```
+
+### 3. Skill・コマンドテーブルに追記
+
+```markdown
+| `einja-skill-advisor` | 作業前のSkill作成必要性評価（Plan/spec-create時に自動起動） |
+```
+
+### 4. キーワードトリガーテーブルに追記（excluded セクション）
+
+```markdown
+| `Skill作るべき？` `Skill化` `skill-advisor` `Skill-first` | `.claude/skills/einja-skill-advisor/SKILL.md` |
+```
+
+## 実装手順
+
+1. **SKILL.md 作成**: `einja-skill-creator` Skill を使用して `.claude/skills/einja-skill-advisor/SKILL.md` を作成
+2. **CLAUDE.md 更新**: テーブル2箇所に追記
+3. **動作確認**: 適当なタスク説明を与えて Skill を呼び出し、評価結果の出力を確認
+
+## 検証方法
+
+- skill-advisor を Task ツールで呼び出し、テストケースで動作確認:
+  - ケース1: 「ログイン画面を作って」→ 既存 Skill（frontend-implement系）でカバー → 不要判定
+  - ケース2: 「Prismaスキーマ変更の自動マイグレーション運用を整備して」→ 既存 Skill にない → 推奨判定
+  - ケース3: 「READMEのtypo修正」→ スキップ基準に該当 → 即座に不要判定

package/templates/default/docs/plans/streamed-purring-wreath.md

@@ -0,0 +1,40 @@
+# Plan: docs/einja/ への手動ファイル作成禁止ルールをCLAUDE.mdに追記
+
+## Context
+
+別リポジトリでこのリポジトリのNPMパッケージ（`@einja/dev-cli`）を利用している際、Agentが `docs/einja/` 配下にドキュメントを手動作成してしまうケースがある。`docs/einja/` はCLIパッケージで管理されるファイル群（`einja sync` で同期）のため、手動作成すると次回sync時に上書き・競合が発生する。
+
+## 変更内容
+
+### CLAUDE.md に「マネージドディレクトリ」セクションを追加
+
+**配置場所**: L108「プロジェクト概要」セクションの直後（L113の後）
+- `@einja:excluded` の外なので、配布先テンプレートにも反映される
+
+**追記内容**:
+
+```markdown
+## マネージドディレクトリ（編集禁止）
+
+`docs/einja/` は `@einja/dev-cli` パッケージで管理されている。`einja sync` で同期されるため、以下のルールを厳守すること。
+
+| ディレクトリ | 操作 | 理由 |
+|------------|------|------|
+| `docs/einja/steering/` | **読み取り専用** | CLI同期で上書きされる |
+| `docs/einja/templates/` | **読み取り専用** | CLI同期で上書きされる |
+| `docs/einja/instructions/` | **読み取り専用** | CLI同期で上書きされる |
+| `docs/einja/example/` | **読み取り専用** | CLI同期で上書きされる |
+| `docs/einja/memory/` | **読み書き可** | プロジェクト固有の学習記録（同期対象外） |
+
+**禁止事項**: `docs/einja/` 配下に新規ファイル・ディレクトリを作成しないこと（`memory/` 内を除く）
+```
+
+### 対象ファイル
+
+- `/Users/kzp/code/GitHub/einja-inc/einja-management-template/CLAUDE.md` (L113の後に追記)
+
+## 検証
+
+1. `@einja:excluded` の外に配置されていることを確認
+2. `node scripts/generate-template.mjs` を実行し、`presets/default/CLAUDE.md.template` に新セクションが含まれることを確認
+3. テンプレート内のプレースホルダー変換に影響がないことを確認

package/templates/default/docs/plans/synthetic-percolating-pearl.md

@@ -0,0 +1,101 @@
+# Plan: Serena MCP活用カスタムExploreエージェント作成
+
+## Context
+
+現在、`Task(subagent_type='Explore')` で呼び出されるExploreサブエージェントはClaudeCode標準のもので、`Read`, `Grep`, `Glob`, `Bash` 等の標準ツールで探索を行う。Serena MCPはLSPベースのシンボルナビゲーション・参照検索等の高度なコード解析機能を持っており、これをExplore時のメインツールとして活用したい。
+
+**目的**: カスタムエージェント定義で標準Exploreを上書きし、すべての具体的探索をSerena MCPで行うエージェントを作成する。
+
+## 方針
+
+- `.claude/agents/einja/` に `Explore` と同名のカスタムエージェントを配置し、ビルトインExploreを上書き
+- **Serena MCP最優先**: 利用不可の場合は警告を出した上でRead/Grep/Globにフォールバック
+- 標準Exploreの基本的な役割（高速な読み取り専用コードベース探索）は踏襲
+- 上書きが機能しない場合のフォールバック: 別名 + CLAUDE.md指示
+
+## 変更対象ファイル
+
+| ファイル | 操作 |
+|---------|------|
+| `.claude/agents/einja/Explore.md` | **新規作成** |
+
+※ 実装時は `einja-skill-creator` Skill を参照してeinja規約に準拠すること
+
+## エージェント定義の設計
+
+### YAMLフロントマッター
+
+```yaml
+---
+name: Explore
+description: Serena MCPを活用した高速コードベース探索エージェント。...（<example>タグ含む）
+tools: Read, Bash, Glob, Grep, ToolSearch, WebFetch, WebSearch, mcp__serena__find_symbol, mcp__serena__get_symbols_overview, mcp__serena__search_for_pattern, mcp__serena__find_file, mcp__serena__list_dir, mcp__serena__find_referencing_symbols, mcp__serena__activate_project, mcp__serena__check_onboarding_performed
+model: sonnet
+color: green
+---
+```
+
+### ツール選定（Codexレビュー反映済み）
+
+| カテゴリ | ツール | 用途 |
+|---------|--------|------|
+| **Serena MCP（最優先）** | find_symbol, get_symbols_overview, search_for_pattern, find_file, list_dir, find_referencing_symbols | シンボル検索、参照検索、パターン検索、ファイル/ディレクトリ探索 |
+| **Serena初期化** | activate_project, check_onboarding_performed | プロジェクト有効化・初期化確認 |
+| **補助（フォールバック含む）** | Read, Glob, Grep | 非コードファイル読み取り、広範なファイルパターン検索 |
+| **読み取り専用Bash** | Bash | `git log`, `git blame`, `git show`, `ls`, `tree` 等 |
+| **ツール管理** | ToolSearch | deferredツール（Serena MCP）の事前ロード |
+| **Web検索** | WebFetch, WebSearch | 外部ドキュメント参照（標準Exploreと同等） |
+| **除外** | Edit, Write, NotebookEdit, Task, ExitPlanMode | 読み取り専用保証 |
+| **除外（Serena編集系）** | replace_symbol_body, insert_before_symbol, insert_after_symbol, rename_symbol | 編集系ツールは一切含めない |
+
+### 本文の構成
+
+#### 1. Serena MCPツール事前ロード手順（必須）
+
+```
+1. ToolSearch(query: "+serena", max_results: 10) で一括ロード
+2. mcp__serena__check_onboarding_performed でSerena初期化確認
+3. 必要に応じて mcp__serena__activate_project でプロジェクト有効化
+```
+
+- ToolSearch結果が空 or エラー → 警告メッセージ出力 → フォールバックモードへ
+
+#### 2. 探索ツール優先順位
+
+| 優先度 | ツール | 使用場面 |
+|--------|--------|---------|
+| 1（最優先） | Serena MCP | シンボル定義検索、参照追跡、パターン検索、ファイル検索 |
+| 2（補助） | Read | 非コードファイル（md, json, yml）、画像、PDF読み取り |
+| 3（補助） | Glob/Grep | Serenaで対応しにくい広範パターン検索、テキスト全文検索 |
+| 4（補助） | Bash（読み取り専用） | git履歴、ファイルメタ情報 |
+
+#### 3. 効率的な探索パターン集
+
+- **シンボル定義 → 参照追跡**: find_symbol → find_referencing_symbols → Read
+- **ディレクトリ構造 → シンボル概要**: list_dir → get_symbols_overview
+- **パターン検索 → 詳細確認**: search_for_pattern → Read
+
+#### 4. 読み取り専用の厳守
+
+**禁止事項（明示的に記載）**:
+- Edit, Write, NotebookEdit の使用
+- Serena編集系ツール（replace_symbol_body等）の使用・ロード
+- Bashでの破壊的操作（rm, mv, git reset, git checkout, リダイレクト等）
+
+**Bash許可コマンド（ホワイトリスト）**:
+- `git log`, `git blame`, `git show`, `git diff`
+- `ls`, `tree`, `wc`, `file`, `stat`
+- `env`, `node -v` 等の環境確認
+
+#### 5. Serena利用不可時のフォールバック
+
+1. 「⚠️ Serena MCP未接続のため、標準ツールで探索を継続します」と通知
+2. Read/Grep/Glob/Bashで作業継続
+3. 完了時に「Serena MCPの設定確認を推奨」とアドバイス
+
+## 検証方法
+
+1. ファイル作成後、新しいセッションで `Task(subagent_type='Explore')` を呼び出し
+2. **上書き成功判定**: エージェントがSerenaツールを使用しているか確認
+3. **上書き失敗時**: `name`を別名（例: `serena-explorer`）に変更し、CLAUDE.mdに「探索は`serena-explorer`を使え」と追記
+4. Serena MCPが未接続の状態でフォールバック動作を確認

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

@@ -0,0 +1,21 @@
+# TODO: fix-sync-template-variables
+
+## Phase 1: 致命的問題の修正
+
+- [x] 1-A: project-detector作成 + replacePlaceholders共用化 + sync/merger統合
+- [x] 1-B: placeholder-validator作成
+- [x] 1-C: env保護強化 + Prisma/lockfile除外パターン追加
+- [x] 1-D: sync.tsにplaceholder-validator統合（1-A, 1-B完了後）
+
+## Phase 2: 重大問題の修正
+
+- [ ] 2-1: package.json scripts の安全なマージ
+- [ ] 2-2: dry-run の改善
+- [ ] 2-3: バックアップの完全性
+
+## Phase 3: テスト
+
+- [ ] 3-1: project-detector テスト
+- [ ] 3-2: placeholder-validator テスト
+- [ ] 3-3: merger templateVariables テスト
+- [ ] 3-4: sync E2E テスト

package/templates/default/docs/plans/todo-phase4-marker-update.md

@@ -0,0 +1,39 @@
+# Phase 4 - マーカー更新 TODO
+
+## 進捗管理
+
+### 4-a: 既存ファイルの `@einja:seed` → `@einja:project-private` 一括置換
+- [ ] 対象ファイルの特定（grep）
+- [ ] docs/einja/steering/ 配下のファイル置換
+- [ ] docs/einja/instructions/ 配下のファイル置換
+- [ ] docs/einja/memory/ 配下のファイル置換
+- [ ] packages/cli/README.md 置換
+- [ ] packages/create-einja-app/README.md 置換
+
+### 4-b: 新規3ファイルにproject-privateセクション追加
+- [ ] coding-standards.md
+- [ ] component-design.md
+- [ ] playwright-guidelines.md
+
+### 4-c: .claude/skills/einja-*/SKILL.md
+- [ ] skill一覧の確認
+- [ ] 各SKILL.mdにセクション追加
+
+### 4-d: .claude/agents/einja/ 配下
+- [ ] ファイル一覧の確認
+- [ ] 各.mdファイルにセクション追加
+
+### 4-e: .claude/commands/einja/ 配下
+- [ ] ファイル一覧の確認
+- [ ] 各.mdファイルにセクション追加
+
+### 4-f: CLAUDE.md
+- [ ] project-privateセクション追加
+
+### 4-g: skill-creatorのドキュメント例示更新
+- [ ] SKILL.md内の例示更新
+- [ ] init_skill.py内の例示更新
+
+### 4-h: ドキュメント内のseed参照更新
+- [ ] MARKER_SPECIFICATION.md確認・更新
+- [ ] 4-aで対応済みか確認

package/templates/default/docs/plans/todo-skill-creator-sync.md

@@ -0,0 +1,23 @@
+# TODO: einja-skill-creator 公式skill-creator最新版との完全同期
+
+## タスク一覧
+
+- [x] 1. SKILL.md の全面更新（7ステップワークフロー、eval/ベンチマーク対応）
+- [x] 2. scripts/package_skill.py の改善（除外パターン追加、import修正）
+- [x] 3. scripts/quick_validate.py の更新（変更不要と判断、einja固有チェック維持）
+- [x] 4. scripts/__init__.py 新規作成
+- [x] 5. scripts/utils.py 新規作成（日本語化）
+- [x] 6. scripts/run_eval.py 新規作成（日本語化）
+- [x] 7. scripts/run_loop.py 新規作成（日本語化）
+- [x] 8. scripts/improve_description.py 新規作成（日本語化）
+- [x] 9. scripts/generate_report.py 新規作成（日本語化）
+- [x] 10. scripts/aggregate_benchmark.py 新規作成（日本語化）
+- [x] 11. references/schemas.md 新規作成（日本語化）
+- [x] 12. agents/grader.md 新規作成（日本語化）
+- [x] 13. agents/comparator.md 新規作成（日本語化）
+- [x] 14. agents/analyzer.md 新規作成（日本語化）
+- [x] 15. assets/eval_review.html 新規作成（英語のまま）
+- [x] 16. eval-viewer/generate_review.py 新規作成（英語のまま、公式そのまま）
+- [x] 17. eval-viewer/viewer.html 新規作成（公式そのまま）
+- [x] 18. init_skill.py テンプレート更新（einja固有セクション簡素化）
+- [x] 19. 検証（validate, package, syntax check）— 全パス