create-einja-app 0.3.2 → 0.3.4

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

@@ -0,0 +1,108 @@
+# Plan: issue-exec Manager を worktree 化し、複数Issue同時実行を可能にする
+
+## Context
+
+現在の `issue-exec` コマンドでは、Manager がメインリポジトリで直接動作する。
+これにより:
+1. 複数Issue同時実行時に git 状態の race condition リスクがある
+2. Manager 実行中にメインリポジトリで手動作業ができない
+
+Manager も worktree で動作させることで、これらを解消する。
+
+**技術的前提**: Git 2.15+ では worktree 内から `git worktree add` / `git branch` / `git push` が可能（検証済み）。
+
+## 変更対象
+
+`.claude/commands/einja/issue-exec.md` （1ファイルのみ）
+
+## 具体的な変更箇所（5箇所）
+
+### 1. Step 2: ブランチ & worktree 作成（L124-137）
+
+Manager worktree を最初に作成し、以降のgit操作はすべて Manager worktree 内から実行する。
+
+```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}
+   ```
+```
+
+### 2. Step 4: tmux セッション作成（L166-168）
+
+Manager の cwd を worktree に指定する。
+
+```bash
+tmux new-session -d -s einja-{issue番号} -n manager -c ~/.einja/worktrees/issue-{N}/manager
+```
+
+### 3. Step 0-3: セッション復元（L112-114）
+
+Manager worktree の存在確認・再作成ロジックを追加。
+
+```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を再起動する
+```
+
+### 4. worktree 物理パス構成図（L266-270）
+
+`manager/` を追加。
+
+```
+~/.einja/worktrees/issue-{N}/
+├── manager/                      ← Manager cwd
+├── phase{M}/                     ← Director cwd
+├── task-{X.Y}/                   ← Worker cwd
+```
+
+### 5. セッションクリーンアップ（L390-395）
+
+Manager worktree を削除対象に追加。
+
+```markdown
+Issue完了時に以下を自動削除:
+- `~/.einja/sessions/issue-{N}/` （セッションファイル）
+- `~/.einja/worktrees/issue-{N}/` （worktree。事前に `git worktree remove` を各ディレクトリに対して実行）
+  - `git worktree remove ~/.einja/worktrees/issue-{N}/task-{X.Y}`（Worker）
+  - `git worktree remove ~/.einja/worktrees/issue-{N}/phase{M}`（Director）
+  - `git worktree remove ~/.einja/worktrees/issue-{N}/manager`（Manager - 最後に削除）
+- ローカルブランチのクリーンアップ（task/*, issue/*-phase*）
+```
+
+## ブランチ構成図の更新
+
+```
+{baseBranch}
+ └── issue/{N}                        Manager worktree（← 変更点）
+      ├── issue/{N}-phase1             Director1 worktree
+      │    ├── task/{N}-1.1            Worker1.1 worktree
+      ...
+```
+
+## 変更しない箇所
+
+- Director/Worker の起動方法
+- ステータスファイル構造（絶対パスで管理）
+- `gh pr create` コマンド
+- `task-exec` コマンド
+- `einja-team-exec` Skill
+
+## 検証方法
+
+1. 変更後の `issue-exec.md` 全体を通読し、Step 0〜7の整合性を確認
+2. worktree 構成図・ブランチ構成図が一致しているか確認

package/templates/default/docs/plans/generic-snuggling-pudding.md

@@ -0,0 +1,57 @@
+# Plan: conflict-resolver サブエージェント廃止 → Skill一本化
+
+## Context
+
+`conflict-resolver` はサブエージェント定義（`.claude/agents/`）とSkill定義（`.claude/skills/`）の2重構造になっている。
+サブエージェント経由では `AskUserQuestion` が使えないため、コンフリクト解消の核心機能（1ファイルずつユーザー確認）が動作しない。
+Skill単体で親エージェントが直接実行すれば `AskUserQuestion` が正常に動作するため、サブエージェント定義を廃止してSkill一本化する。
+
+## 変更内容
+
+### TODO-1: エージェント定義の削除
+
+**削除ファイル:**
+- `.claude/agents/einja/git/conflict-resolver.md`
+
+### TODO-2: CLAUDE.md の参照更新
+
+**ファイル:** `CLAUDE.md`
+
+- **行29**: サブエージェント委託テーブルから `コンフリクト解消 → conflict-resolver` の行を削除
+- **行41**: Skill テーブルの `einja-conflict-resolver` はそのまま維持
+- **行92**: `gitコンフリクト発生時の対応` セクションもそのまま維持（既にSkillを参照している）
+
+### TODO-3: einja-task-commit Skill の参照更新
+
+**ファイル:** `.claude/skills/einja-task-commit/SKILL.md`
+
+- **行52**: `conflict-resolver エージェント を Task ツールで呼び出して解消` → `einja-conflict-resolver Skill の手順に従って解消`
+- **行256**: `conflict-resolver エージェントを Task ツールで呼び出して解消を試行` → `einja-conflict-resolver Skill の手順に従って解消を試行`
+
+### TODO-4: issue-exec コマンドの参照更新
+
+**ファイル:** `.claude/commands/einja/issue-exec.md`
+
+- **行349**: `conflict-resolverで自力解消` → `einja-conflict-resolver Skillで自力解消`
+
+### TODO-5: .einja-sync.json のエントリ削除
+
+**ファイル:** `.einja-sync.json`
+
+- agent定義のsyncエントリ（`.claude/agents/einja/git/conflict-resolver.md`）を削除
+
+### 変更不要（参照のみ・読み取り専用）
+
+| ファイル | 理由 |
+|---------|------|
+| `docs/einja/steering/branch-strategy.md` | マネージドディレクトリ（読み取り専用）※ただしこのリポジトリでは編集可。"conflict-resolver で解消"は曖昧でSkillを指すとも読めるため変更不要 |
+| `docs/einja/instructions/issue-exec-workflow.md` | 同上 |
+| `docs/plans/*.md` | 過去のPlan。履歴として変更不要 |
+| `.claude/commands/einja/einja-sync.md` | "einja-conflict-resolver Skill は使用しない"の記述。変更不要 |
+| `.claude/skills/einja-conflict-resolver/SKILL.md` | Skill本体。変更不要 |
+
+## 検証
+
+1. `grep -r "conflict-resolver" .claude/agents/` でエージェント定義が残っていないことを確認
+2. `grep -r "conflict-resolver.*エージェント.*Task" .claude/ CLAUDE.md` でサブエージェント呼び出し記述が残っていないことを確認
+3. `pnpm prepush` でlint/typecheck/testが通ることを確認

package/templates/default/docs/plans/glistening-conjuring-cascade.md

@@ -0,0 +1,42 @@
+# Plan: npx コマンドの `@latest` 指定漏れを一括修正
+
+## Context
+
+`npx @einja/dev-cli` を `@latest` なしで実行すると、npxキャッシュの古いバージョンが使われる。`einja:einja-sync` コマンドでv0.1.0が使われてしまった。実行されるコマンド/スクリプト定義を修正する。
+
+## 修正対象
+
+### 1. `.claude/commands/einja/einja-sync.md` (6箇所)
+
+`npx --yes` で実行するコマンドに `@latest` を追加。`replace_all` で一括置換。
+
+| Before | After |
+|--------|-------|
+| `npx --yes @einja/dev-cli sync` (4箇所: 107,159,162,231行) | `npx --yes @einja/dev-cli@latest sync` |
+| `npx --yes create-einja-app sync` (2箇所: 110,165行) | `npx --yes create-einja-app@latest sync` |
+
+**修正しない箇所**: Step 1のCLI検出 (19,20行目) は `npx --no` のまま。目的が「CLIが利用可能か」の検出であり、バージョン不問で検出できる方が適切。実際のsync実行 (Step 3,4) では `--yes @latest` で最新版が使われる。
+
+### 2. `docs/einja/cli/preset.yaml` (2箇所)
+
+下流プロジェクトの `package.json` scripts に反映されるため修正必須。
+
+| 行 | Before | After |
+|----|--------|-------|
+| 127 | `"task:loop": "npx @einja/dev-cli task:loop"` | `"task:loop": "npx @einja/dev-cli@latest task:loop"` |
+| 128 | `"einja:sync": "npx @einja/dev-cli sync"` | `"einja:sync": "npx @einja/dev-cli@latest sync"` |
+
+## 修正不要
+
+| ファイル | 理由 |
+|---------|------|
+| `einja-sync.md` 19,20行 | Step 1のCLI検出。`--no` で検出目的のためバージョン不問 |
+| `package.json` (ルート) | 既に `@latest` 付き |
+| `create-einja-app/src/generators/post-setup.ts` | 既に `@latest` 付き |
+| README.md / docs/plans/ / docs/specs/ 等 | ドキュメント内の説明・例示。直接実行されるコマンドではない |
+
+## 検証
+
+1. grep で `einja-sync.md` 内の `npx --yes` 呼び出しに全て `@latest` が付いていることを確認
+2. `preset.yaml` のscripts定義に `@latest` が付いていることを確認
+3. `pnpm build` して `presets/default/` に変更が反映されることを確認

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で再開してコンテキストが維持されていることを確認