create-einja-app 0.3.2 → 0.3.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-einja-app",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "CLI tool to create new projects with Einja Management Template",
   "type": "module",
   "bin": {

package/templates/default/.changeset/config.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.0.0/schema.json",
+  "changelog": ["@changesets/changelog-github", { "repo": "einja-inc/einja-management-template" }],
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "restricted",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": ["@einja/dev-cli", "create-einja-app"]
+}

package/templates/default/.claude/hooks/einja/plan-mode-skill-loader.sh

@@ -18,6 +18,10 @@ if [[ "$permission_mode" != "plan" ]]; then
 fi
 
 # 軽量リマインダーを注入
+# UserPromptSubmit の additionalContext は hookSpecificOutput 内に配置する必要がある
 jq -n '{
-  "additionalContext": "【Plan mode自動リマインダー】計画作成前にeinja-skill-firstの評価を実施してください。.claude/skills/einja-skill-first/SKILL.mdを参照し、スキップ基準に該当しない場合はSkill作成の必要性を評価してください。スキップ基準（単発の小規模修正、既存キーワードトリガー一致、具体的かつ限定的な作業指示、1回限りの作業）に該当する場合は省略可。"
+  "hookSpecificOutput": {
+    "hookEventName": "UserPromptSubmit",
+    "additionalContext": "【Plan mode自動リマインダー】計画作成前にeinja-skill-firstの評価を実施してください。.claude/skills/einja-skill-first/SKILL.mdを参照し、スキップ基準に該当しない場合はSkill作成の必要性を評価してください。スキップ基準（単発の小規模修正、既存キーワードトリガー一致、具体的かつ限定的な作業指示、1回限りの作業）に該当する場合は省略可。"
+  }
 }'

package/templates/default/.claude/settings.json

@@ -78,6 +78,20 @@
       "mcp__playwright__browser_network_requests",
       "mcp__playwright__browser_close",
       "mcp__playwright__browser_resize",
+      "mcp__pencil__batch_design",
+      "mcp__pencil__batch_get",
+      "mcp__pencil__find_empty_space_on_canvas",
+      "mcp__pencil__get_editor_state",
+      "mcp__pencil__get_guidelines",
+      "mcp__pencil__get_screenshot",
+      "mcp__pencil__get_style_guide",
+      "mcp__pencil__get_style_guide_tags",
+      "mcp__pencil__get_variables",
+      "mcp__pencil__open_document",
+      "mcp__pencil__replace_all_matching_properties",
+      "mcp__pencil__search_all_unique_properties",
+      "mcp__pencil__set_variables",
+      "mcp__pencil__snapshot_layout",
       "mcp__serena",
       "mcp__serena__activate_project",
       "mcp__serena__check_onboarding_performed",
@@ -128,10 +142,6 @@
           {
             "type": "command",
             "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/einja/unset-volta-recursion.sh"
-          },
-          {
-            "type": "command",
-            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/einja/validate-git-commit.sh"
           }
         ]
       },

package/templates/default/.claude/skills/_einja-general-context-loader/SKILL.md

@@ -0,0 +1,258 @@
+---
+name: _einja-general-context-loader
+description: "spec（仕様書）が存在しない場合の文脈収集を担当するSkill。Issue本文、ユーザー指示、関連コードから要件を推測し、曖昧な点をAskUserQuestionで確認します"
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - AskUserQuestion
+  - mcp__github__issue_read
+  - mcp__serena__*
+---
+
+# general-context-loader Skill: 指示ベースの文脈収集
+
+あなたは要件分析のスペシャリストで、曖昧な指示から具体的な実装要件を導き出す能力に長けています。ユーザーとの対話を通じて、実装に必要な情報を効率的に収集します。
+
+## 中核的な責務
+
+spec が存在しない場合に、Issue 本文・ユーザー指示・関連コードから実装に必要な文脈を収集し、曖昧な点を AskUserQuestion で確認して明確化します。
+
+---
+
+## 入力
+
+**必須パラメータ**:
+- `issue_number`: GitHub Issue 番号（例: `21`）
+- `user_instruction`: ユーザーからの指示内容
+
+**オプションパラメータ**:
+- `task_description`: タスクの追加説明
+
+**入力形式**: `--issue {issue_number} --instruction "{user_instruction}"`
+
+---
+
+## 実行手順（5ステップ）
+
+### ステップ1: Issue 情報の取得
+
+1. GitHub MCP を使用して Issue 本文を取得
+2. 以下の情報を抽出:
+   - **タイトル**: Issue のタイトル
+   - **説明**: Issue の本文（AS-IS/TO-BE があれば優先的に抽出）
+   - **ラベル**: 関連ラベル（feature, bug, enhancement 等）
+   - **コメント**: 追加の議論や要件
+
+**Issue が存在しない場合**: ユーザー指示のみから要件を推測
+
+---
+
+### ステップ2: 関連コードの探索
+
+1. Issue 本文・ユーザー指示からキーワードを抽出
+2. Serena MCP または Grep/Glob を使用して関連ファイルを探索:
+   - **既存実装**: 修正対象のファイル
+   - **類似実装**: 参考にできる既存コード
+   - **テストコード**: 既存のテストパターン
+3. 最大10ファイルまで関連コードをリストアップ
+
+---
+
+### ステップ3: 要件の推測と整理
+
+1. 収集した情報から以下を推測:
+   - **目的**: なぜこの変更が必要か
+   - **スコープ**: 何を変更するか
+   - **制約**: どのような制約があるか
+   - **期待される動作**: 完了時にどうなっているべきか
+
+2. 推測の確信度を評価:
+   - **高**: Issue 本文に明記されている
+   - **中**: 文脈から推測可能
+   - **低**: 複数の解釈が可能
+
+---
+
+### ステップ4: 曖昧点の確認
+
+**確信度が「低」の項目がある場合**、AskUserQuestion で確認します。
+
+**確認すべき典型的な項目**:
+
+| カテゴリ | 確認項目例 |
+|---------|----------|
+| スコープ | 「この変更は○○にも影響しますか？」 |
+| 実装方法 | 「AパターンとBパターン、どちらで実装しますか？」 |
+| エラー処理 | 「エラー時の挙動はどうすべきですか？」 |
+| テスト | 「どのレベルのテストが必要ですか？」 |
+| 破壊的変更 | 「既存の○○を変更しても問題ありませんか？」 |
+
+**AskUserQuestion の使用例**:
+
+```
+質問: 実装アプローチの選択
+
+この機能は以下のどちらで実装しますか？
+
+1. Server Component として実装（推奨）
+   - SSRでデータ取得、SEO対応
+
+2. Client Component として実装
+   - リアルタイム更新が必要な場合
+
+3. ハイブリッド
+   - 静的部分はServer、動的部分はClient
+```
+
+---
+
+### ステップ5: 結果の構造化
+
+収集・確認した情報を構造化して出力します。
+
+---
+
+## 出力形式
+
+**成功時**: 以下のマークダウン形式で出力（spec-context-loader と共通構造）
+
+```markdown
+## コンテキスト収集結果
+
+### spec 情報
+- **ディレクトリ**: なし（指示ベース実装）
+- **Issue**: #{issue_number} - {title}
+- **ユーザー指示**: {instruction}
+
+### 要件
+#### 機能要件（推測）
+- {目的: なぜこの変更が必要か}
+- {スコープ: 何を変更するか}
+
+#### 非機能要件
+- {技術的制約}
+- {ビジネス的制約}
+
+#### 受け入れ条件（推測）
+| AC番号 | タイトル | 検証レベル | 概要 |
+|--------|---------|-----------|------|
+| - | {期待される動作1} | Unit/Integration/E2E | {概要} |
+
+### 設計
+#### アーキテクチャ（推測）
+- **パターン**: {推測されるアーキテクチャパターン}
+- **レイヤー**: {影響するレイヤー}
+
+#### データ構造（推測）
+```typescript
+// 主要な型定義（推測）
+interface Example {
+  // ...
+}
+```
+
+#### API仕様（推測）
+- **エンドポイント**: {該当する場合}
+- **リクエスト**: {形式}
+- **レスポンス**: {形式}
+
+#### エラーハンドリング（推測）
+- {エラー分類と処理方針}
+
+#### 関連コード
+| ファイル | 関連性 | 説明 |
+|---------|-------|------|
+| `src/app/example/page.tsx` | 修正対象 | メイン画面 |
+| `src/components/Example.tsx` | 参考 | 類似コンポーネント |
+
+### テスト仕様
+#### 対象テストファイル（推測）
+- {該当するテストファイル}
+
+#### シナリオテスト（推測）
+- **シナリオ1**: {概要}
+
+#### 確認項目
+1. {確認項目1}
+2. {確認項目2}
+
+#### テスト方針
+- **単体テスト**: {必要/不要}
+- **統合テスト**: {必要/不要}
+- **E2Eテスト**: {必要/不要}
+
+### 確認済み事項
+- [x] {AskUserQuestion で確認した項目1}: {回答}
+- [x] {AskUserQuestion で確認した項目2}: {回答}
+```
+
+**情報不足時**: 以下の形式で出力
+
+```markdown
+## コンテキスト収集結果
+
+### ステータス: ⚠️ 情報不足
+
+### 収集できた情報
+- {収集できた情報}
+
+### 不足している情報
+- {不足1}: {なぜ必要か}
+- {不足2}: {なぜ必要か}
+
+### 推奨アクション
+1. ユーザーに追加情報を求める
+2. または `einja-issue-spec-create` Skillで仕様書を作成する
+```
+
+---
+
+## AskUserQuestion 使用ガイドライン
+
+### 使用すべき場面
+- 複数の実装方法が考えられる場合
+- 破壊的変更の可能性がある場合
+- テスト方針が不明確な場合
+- スコープの境界が曖昧な場合
+
+### 使用を避けるべき場面
+- Issue 本文に明記されている場合
+- プロジェクトの規約で決まっている場合
+- 技術的に選択肢が1つしかない場合
+
+### 質問のベストプラクティス
+- 選択肢を2-4個に絞る
+- 各選択肢のトレードオフを説明
+- 推奨オプションを明示（「推奨」と記載）
+
+---
+
+## エラー処理
+
+| エラー種別 | 原因 | 対処 |
+|-----------|------|------|
+| Issue 取得失敗 | Issue が存在しない/アクセス権限なし | ユーザー指示のみから要件を推測 |
+| 関連コード不在 | 新規機能で既存コードがない | 類似機能を探索、なければ新規作成前提 |
+| 要件が完全に不明 | 指示が抽象的すぎる | AskUserQuestion で段階的に明確化 |
+
+---
+
+## 実行制約
+
+このSkillは `task-executer` エージェントから呼び出されます。spec が存在しないことが前提です。
+
+---
+
+## 連携
+
+- **呼び出し元**: `task-executer` - コンテキスト収集フェーズ
+- **代替Skill**: `spec-context-loader` - spec がある場合の文脈収集
+
+---
+
+**最終更新**: 2025-01-10
+
+<!-- @einja:project-private:start id="einja-general-context-loader-project" -->
+<!-- プロジェクト固有の情報を記入 -->
+<!-- @einja:project-private:end -->

package/templates/default/.claude/skills/_einja-output-format/SKILL.md

@@ -0,0 +1,211 @@
+---
+name: _einja-output-format
+description: "サブエージェントの統一出力形式を定義"
+---
+
+# サブエージェント出力形式 Skill
+
+## 概要
+
+このSkillは、全サブエージェントが従うべき出力形式を定義します。
+
+## 必須ルール
+
+1. **完全出力の原則**: 最終出力はそのまま全文をユーザーに表示
+2. **省略・要約の禁止**: 出力を要約したり、一部のみ抜粋することは禁止
+3. **この形式から逸脱しないこと**
+
+## 標準出力構造
+
+すべてのサブエージェントは以下の構造で出力すること：
+
+```markdown
+## [絵文字] [フェーズ名]完了
+
+### タスク: [タスクID] - [タスク名]
+
+### 結果: [✅ SUCCESS / ❌ FAILURE / ⚠️ PARTIAL]
+
+### サマリー
+[主要な結果・数値]
+
+### 詳細
+[項目別の詳細情報]
+
+### 次のステップ
+[後続処理の説明]
+```
+
+## エージェント別テンプレート
+
+### frontend-architect
+
+```markdown
+## 🏗️ アーキテクチャ設計完了
+
+### タスク: [機能名/画面名]
+
+### 設計結果: [✅ SUCCESS / ⚠️ PARTIAL / ❌ FAILURE]
+
+### 設計サマリー
+- **コンポーネント数**: N個
+- **カスタムHooks数**: M個
+- **新規ディレクトリ**: K個
+
+### コンポーネント構造
+```
+[ディレクトリ構造図]
+```
+
+### 状態管理戦略
+| 状態種別 | 管理方法 | 対象データ |
+|---------|---------|----------|
+
+### 技術選定
+- **[決定1]**: [選定理由]
+
+### 次のステップ
+[後続処理の説明]
+```
+
+### design-engineer
+
+```markdown
+## 🎨 デザインエンジニアリング完了
+
+### タスク: [タスク名/コンポーネント名]
+
+### 実装結果: [✅ SUCCESS / ⚠️ PARTIAL / ❌ FAILURE]
+
+### 抽出したデザイントークン
+| カテゴリ | 項目数 | 主な値 |
+|---------|-------|-------|
+
+### 生成/更新したファイル
+- **新規作成**: N個
+- **編集**: M個
+
+### 次のステップ
+[後続処理の説明]
+```
+
+### frontend-coder
+
+```markdown
+## 💻 フロントエンド実装完了
+
+### タスク: [タスクID] - [タスク名]
+
+### 実装結果: [✅ SUCCESS / ⚠️ PARTIAL / ❌ FAILURE]
+
+### 実装サマリー
+- **新規作成**: N個のファイル
+- **編集**: M個のファイル
+
+### 主要な実装内容
+1. [実装した主要機能]
+
+### ファイル一覧
+| ファイル | 説明/変更内容 |
+|---------|--------------|
+
+### 次のステップ
+[後続処理の説明]
+```
+
+### backend-architect
+
+```markdown
+## 🔧 バックエンドアーキテクチャ設計完了
+
+### タスク: [機能名/API名]
+
+### 設計結果: [✅ SUCCESS / ⚠️ PARTIAL / ❌ FAILURE]
+
+### 設計サマリー
+- **API数**: N個
+- **Repository数**: M個
+- **UseCase数**: K個
+- **新規Entity数**: L個
+- **テーブル数**: P個
+
+### アーキテクチャ構造
+```
+[ディレクトリ構造図]
+```
+
+### 層間の依存関係
+| 層 | 依存先 | 主なコンポーネント |
+|---|-------|-----------------|
+
+### デザインパターン適用
+- **Repositoryパターン**: [適用状況]
+- **Mapperパターン**: [適用状況]
+- **Result型パターン**: [適用状況]
+
+### DB設計
+| テーブル名 | 主なカラム | インデックス |
+|----------|----------|------------|
+
+### API設計
+| エンドポイント | メソッド | 説明 |
+|--------------|--------|------|
+
+### テスト設計方針
+- **ユニットテスト対象**: [対象コンポーネント]
+- **統合テスト対象**: [対象フロー]
+
+### 技術選定
+- **[決定1]**: [選定理由]
+
+### 次のステップ
+[後続処理の説明]
+```
+
+### codex-agent
+
+```markdown
+## 🤖 Codex作業完了
+
+### タスク: [作業内容]
+
+### 作業結果: [✅ SUCCESS / ⚠️ PARTIAL / ❌ FAILURE]
+
+### 作業モード: [レビュー / 実装 / バグ修正 / リファクタリング / 調査]
+
+### サマリー
+[主要な結果・数値]
+
+### 詳細
+[Codexからの出力・分析結果]
+
+### 次のステップ
+[後続処理の説明]
+```
+
+## 長い出力の取り扱い
+
+出力が50行を超える場合、以下の形式で表示：
+
+```markdown
+### サマリー
+[最初の10行]
+
+### 詳細
+<details>
+<summary>全文を表示（N行）</summary>
+
+[残りの出力全文]
+
+</details>
+```
+
+## 失敗・エラー時
+
+- **エラーステータス**: ❌ FAILURE / ⚠️ PARTIAL
+- **エラー内容**: 具体的なエラーメッセージ
+- **次のアクション**: 推奨される対処方法
+
+<!-- @einja:project-private:start id="einja-output-format-project" -->
+<!-- プロジェクト固有の情報を記入 -->
+<!-- @einja:project-private:end -->

package/templates/default/.claude/skills/_einja-project-overview/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: _einja-project-overview
+description: "プロジェクトの全体構成・技術スタックの参照ハブ"
+---
+
+# プロジェクト概要 Skill
+
+## 概要
+
+このSkillは、プロジェクトの全体構成・技術スタックを把握したいときに参照するエントリポイントです。
+具体的な情報は以下のドキュメントを参照してください。
+
+## 参照ドキュメント
+
+### ドキュメントナビゲーション
+
+@docs/einja/steering/README.md
+
+### プロダクトビジョン
+
+@docs/einja/steering/product.md
+
+### アーキテクチャ・技術スタック
+
+@docs/einja/steering/architecture.md
+
+<!-- @einja:project-private:start id="einja-project-overview-project" -->
+<!-- プロジェクト固有の情報を記入 -->
+<!-- @einja:project-private:end -->