create-einja-app 0.3.1 → 0.3.3

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-create-einja-app-ux-fix.md

@@ -0,0 +1,16 @@
+# TODO: create-einja-app 利用者体験の改善
+
+## 進捗
+
+| # | タスク | 状態 | 担当 |
+|---|--------|------|------|
+| 1 | template.ts に `.sh` ファイルの実行権限付与処理を追加 | ✅ 完了 | sub-agent-1 |
+| 2 | init.sh から `pnpm install` を削除（2ファイル） | ✅ 完了 | sub-agent-2 |
+| 3 | README にトラブルシューティング項目を追加 | ✅ 完了 | sub-agent-3 |
+| 4 | テストのモック順修正 | ✅ 完了 | sub-agent-4 |
+| 5 | 検証（テスト・lint・typecheck） | ✅ 完了 | 親エージェント |
+
+## 検証結果
+- `pnpm -F create-einja-app test`: 108テスト全パス
+- `pnpm prepush`: lint + typecheck + test 全7タスク成功
+- テンプレート `templates/default/` は `.gitignore` 管理。ビルド時に `scripts/init.sh` から自動生成

package/templates/default/docs/plans/todo-direnv-hang-fix.md

@@ -0,0 +1,12 @@
+# TODO: direnvハング修正 + 秘密鍵ローテーション自動化
+
+## 進捗
+
+| TODO | 内容 | 担当 | 状態 |
+|------|------|------|------|
+| TODO-1 | ensure-serena.sh: lsof → nc -z | Agent-A | ✅ 完了 |
+| TODO-2 | env-rotate-secrets.ts: 非対話モード追加 | Agent-B | ✅ 完了 |
+| TODO-3 | post-setup.ts: 処理順序変更 + 自動ローテーション | Agent-C | ✅ 完了 |
+| TODO-4 | .gitignore: .bak パターン追加 | Agent-C | ✅ 完了 |
+| 検証 | prepush (lint + typecheck + test) | 親 | ✅ 全パス |
+| 検証 | git diff 確認 | 親 | ✅ 意図通り |

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-github-actions-release-workflow.md

@@ -0,0 +1,34 @@
+# TODO: GitHub Actions リリースワークフロー + 承認フロー
+
+## Phase 1: changesets基盤導入
+- [x] `package.json` に devDependencies + scripts 追加
+- [x] `.changeset/config.json` 新規作成
+- [x] `pnpm install` で依存関係インストール
+
+## Phase 3: deploy-stable-branches.yml 大規模改修
+- [x] ワークフロー全体ガード（無限ループ防止）追加
+- [x] `permissions: contents: write` 追加
+- [x] migrate ジョブをブランチ別に分割
+- [x] deploy ジョブをブランチ別に分割（develop/staging/production）
+- [x] release-staging ジョブ追加（PreRelease作成）
+- [x] release-production ジョブ追加（changeset消費 + Release作成）
+
+## Phase 4: .github/release.yml
+- [x] リリースノート設定ファイル新規作成
+
+## Phase 5: changeset-status.yml
+- [x] PR上のchangesetステータス表示ワークフロー新規作成
+
+## Phase 6: einja-create-pr Skill
+- [x] `.claude/skills/einja-create-pr/SKILL.md` 新規作成
+- [x] `.claude/commands/einja/issue-exec.md` のPR作成部分をeinja-create-pr呼び出しに変更
+
+## Phase 7: ドキュメント追記
+- [x] `docs/einja/steering/infrastructure/deployment.md` にリリース管理セクション追記
+- [x] `docs/einja/steering/development-workflow.md` にchangeset運用フロー追記
+
+## 検証
+- [x] YAML構文検証（deploy-stable-branches.yml, changeset-status.yml）
+- [x] JSON構文検証（.changeset/config.json）
+- [x] ワークフロージョブ構造確認（9ジョブ、ブランチ別分岐、環境設定）
+- [x] `pnpm prepush` 通過（lint + typecheck + test）

package/templates/default/docs/plans/todo-issue-spec-rename.md

@@ -0,0 +1,24 @@
+# TODO: task-spec → issue-spec リネーム + コマンド→Skill移行
+
+## Phase 1: ファイル移動・作成
+
+- [x] TG-1.1: エージェントディレクトリ移動+ファイルリネーム
+- [x] TG-1.2: スキルディレクトリリネーム
+- [x] TG-1.3: spec-create → einja-issue-spec-create Skill移行
+- [x] TG-1.4: task-exec → einja-task-exec Skill移行
+- [x] TG-1.5: update-docs-by-task-specs リネーム
+
+## Phase 2: 参照更新
+
+- [x] TG-2.1: エージェント内部参照更新（10ファイル）
+- [x] TG-2.2: スキル内部参照更新（9ファイル）
+- [x] TG-2.3: コマンド/設定ファイル参照更新（4ファイル）
+- [x] TG-2.4: docs/einja/ 参照更新（5ファイル）
+- [x] TG-2.5: CLAUDE.md + README.md 更新
+
+## Phase 3: 検証
+
+- [x] TG-3.1: 参照整合性チェック（旧パス残存ゼロ確認、1箇所修正）
+- [x] TG-3.2: pnpm prepush 通過確認
+- [x] TG-3.2: .cursor/commands/ 旧ファイル手動削除
+- [ ] TG-3.2: sync-cursor-commands 再生成（コミット後に実行推奨）

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）— 全パス

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

@@ -0,0 +1,18 @@
+# TODO: einja-skill-creator 公式版追従改善
+
+## Phase 0: plan-mode-skill-loader.sh hook修正
+- [x] hookのデバッグ・修正（`hookSpecificOutput`内に`additionalContext`を配置）
+
+## Phase 1: スクリプト互換性修正
+- [x] 1-a. run_loop.py を公式版ベースに再構築（holdout float化、並列バッチ評価、blinded_history、ブラウザ自動起動、results-dir）
+- [x] 1-b. improve_description.py のblinded_history対応（test_results引数削除）
+- [x] 1-c. aggregate_benchmark.py を公式版に差し替え（旧版→compare_runs.py）
+
+## Phase 2: SKILL.md内容補完
+- [x] 2-a. Phase 1連動のコマンド例更新（holdout 0.4、improve-model、results-dir記載）
+- [x] 2-b. 公式版の重要な詳細を追記（#5 grading.jsonフィールド警告, #6 eval query Good/Bad例, #7 タイミング即時処理, #8 コアループ再掲+TodoList, #9 Claude.ai制限拡充, #12 feedback.jsonスキーマ, #13 Coworkアクセス注記）
+- [x] 2-c. compare_runs.py の説明追加
+
+## Phase 3: UX改善
+- [x] generate_report.py のstdin対応追加（位置引数、-o省略可、stdoutデフォルト）
+- [x] 回帰テスト（init_skill.py, quick_validate.py構文チェック・import確認）