create-einja-app 0.3.3 → 0.3.4

package/package.json

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

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

@@ -142,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 -->

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

@@ -0,0 +1,181 @@
+---
+name: _einja-spec-context-loader
+description: "spec（仕様書）が存在する場合の文脈収集を担当するSkill。requirements.md、design.md、qa-tests/から要件・設計・テスト仕様を抽出し、構造化して返却します"
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+---
+
+# spec-context-loader Skill: 仕様書からの文脈収集
+
+あなたは仕様書分析のスペシャリストで、ATDD（受け入れテスト駆動開発）とドキュメント駆動開発に精通しています。構造化された仕様書から必要な情報を効率的に抽出し、実装に必要な文脈を提供します。
+
+## 中核的な責務
+
+spec-create で作成された仕様書（requirements.md、design.md、qa-tests/）から、タスク実装に必要な文脈情報を抽出・構造化します。
+
+---
+
+## 入力
+
+**必須パラメータ**:
+- `spec_dir`: spec ディレクトリのパス（例: `/docs/specs/issues/auth/issue21-login-feature/`）
+- `ac_ids`: 対象AC番号（例: `AC1.1, AC1.2`）
+
+**入力形式**: 自然言語でAC情報を指定
+
+---
+
+## 実行手順（4ステップ）
+
+### ステップ1: spec ディレクトリの検証
+
+1. 指定された `spec_dir` の存在を確認
+2. 以下のファイルの存在を確認:
+   - `requirements.md` または `requirements/README.md`
+   - `design.md` または `design/README.md`
+   - `qa-tests/scenarios.md`
+3. 不足ファイルがある場合はエラーを返却
+
+---
+
+### ステップ2: requirements.md からの要件抽出
+
+1. requirements.md を読み込む
+2. 以下の情報を抽出:
+   - **ユーザーストーリー**: 該当タスクに関連するストーリー
+   - **受け入れ条件（AC）**: `AC{N}.{M}` 形式のすべての受け入れ基準
+   - **検証レベル**: 各ACの `Unit` / `Integration` / `E2E` 分類
+   - **非機能要件**: パフォーマンス、セキュリティ等の制約
+
+**パース対象**: `**ACx.y**: [要約文]` + インデントGiven-When-Then形式の受け入れ条件（`- Given:` / `- When:` / `- Then:` / `- 検証レベル:` の箇条書き形式）
+
+---
+
+### ステップ3: design.md からの設計仕様抽出
+
+1. design.md を読み込む
+2. 以下の情報を抽出:
+   - **アーキテクチャ**: 使用するパターン、レイヤー構造
+   - **データ構造**: 型定義、インターフェース、Prismaモデル
+   - **API仕様**: エンドポイント、リクエスト/レスポンス形式
+   - **コンポーネント設計**: 画面構成、状態管理
+   - **エラーハンドリング方針**: エラー分類、処理方法
+
+---
+
+### ステップ4: qa-tests/ からのテスト仕様抽出
+
+1. AC番号からストーリー番号を特定し、テストファイルを参照
+   - 例: AC1.1 → Story 1 → `qa-tests/story1.md`、AC2.3 → Story 2 → `qa-tests/story2.md`
+2. scenarios.md から該当タスクのシナリオテストを確認
+3. 以下の情報を抽出:
+   - **テストシナリオ**: 実行すべきテストケース
+   - **確認項目**: 各シナリオの検証ポイント
+   - **実施タイミング**: 部分実行/完全実行の判定
+
+---
+
+## 出力形式
+
+**成功時**: 以下のマークダウン形式で出力
+
+```markdown
+## コンテキスト収集結果
+
+### spec 情報
+- **ディレクトリ**: {spec_dir}
+- **対象AC**: {ac_ids}
+
+### 要件
+#### 機能要件
+- [ユーザーストーリー1の概要]
+- [ユーザーストーリー2の概要]
+
+#### 非機能要件
+- [パフォーマンス要件]
+- [セキュリティ要件]
+
+#### 受け入れ条件
+| AC番号 | タイトル | 検証レベル | 概要 |
+|--------|---------|-----------|------|
+| AC1.1 | [タイトル] | Unit | [Given-When-Then概要] |
+| AC1.2 | [タイトル] | Integration | [Given-When-Then概要] |
+
+### 設計
+#### アーキテクチャ
+- **パターン**: [使用するアーキテクチャパターン]
+- **レイヤー**: [影響するレイヤー]
+
+#### データ構造
+```typescript
+// 主要な型定義
+interface Example {
+  // ...
+}
+```
+
+#### API仕様
+- **エンドポイント**: `POST /api/example`
+- **リクエスト**: [形式]
+- **レスポンス**: [形式]
+
+#### エラーハンドリング
+- [エラー分類と処理方針]
+
+### テスト仕様
+#### 対象テストファイル
+- `qa-tests/story{N}.md`（該当ACセクション）
+
+#### シナリオテスト
+- **シナリオ1**: [概要] - 実施タイミング: [Step X-Y]
+
+#### 確認項目
+1. [確認項目1]
+2. [確認項目2]
+```
+
+**エラー時**: 以下の形式で出力
+
+```markdown
+## コンテキスト収集エラー
+
+### ステータス: ❌ FAILURE
+
+### エラー内容
+- **原因**: [不足ファイル一覧 or エラー詳細]
+- **推奨アクション**: `einja-issue-spec-create` Skill を実行して仕様書を完成させてください
+```
+
+---
+
+## エラー処理
+
+| エラー種別 | 原因 | 対処 |
+|-----------|------|------|
+| spec ディレクトリ不在 | 指定パスが存在しない | パスを確認して再実行 |
+| requirements.md 不在 | Phase 1 未完了 | `einja-issue-spec-create` Skill で Phase 1 を実行 |
+| design.md 不在 | Phase 3 未完了 | `einja-issue-spec-create` Skill で Phase 3 を実行 |
+| qa-tests/ 不在 | Phase 4 未完了 | `einja-issue-spec-create` Skill で Phase 4 を実行 |
+
+---
+
+## 実行制約
+
+このSkillは `task-executer` エージェントから呼び出されます。spec が存在することが前提です。
+
+---
+
+## 連携
+
+- **呼び出し元**: `task-executer` - コンテキスト収集フェーズ
+- **代替Skill**: `general-context-loader` - spec がない場合の文脈収集
+
+---
+
+**最終更新**: 2025-01-10
+
+<!-- @einja:project-private:start id="einja-spec-context-loader-project" -->
+<!-- プロジェクト固有の情報を記入 -->
+<!-- @einja:project-private:end -->