create-einja-app 0.3.2 → 0.3.4

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 -->

package/templates/default/.claude/skills/cli-package-specs/SKILL.md

@@ -0,0 +1,294 @@
+---
+name: cli-package-specs
+description: "@einja/dev-cli と create-einja-app のビルド・テンプレート仕様リファレンス。ファイルマッピング、マーカー仕様、コピーフィルタ条件を集約"
+---
+
+# CLI パッケージ ビルド・テンプレート仕様リファレンス
+
+## 概要
+
+このSkillは、2つのCLIパッケージのビルドパイプライン・テンプレート仕様を集約したリファレンスです。
+`einja-` プレフィックスを持たないため、`presets/default/` にはコピーされません。
+
+| パッケージ | 役割 |
+|-----------|------|
+| `@einja/dev-cli` (`packages/cli`) | 既存プロジェクトへの `.claude/` 設定・`docs/einja/` 同期。`einja init` / `einja sync` コマンドを提供 |
+| `create-einja-app` (`packages/create-einja-app`) | 新規プロジェクトのスキャフォールディング。テンプレートからプロジェクト全体を生成 |
+
+---
+
+## 1. ビルドパイプライン
+
+### 1.1 `@einja/dev-cli` ビルド
+
+`packages/cli/package.json` L21:
+```
+"prebuild": "node ./scripts/generate-template.mjs && node ./scripts/copy-presets.mjs"
+```
+
+#### Step 1: CLAUDE.md.template 生成
+- **スクリプト**: `packages/cli/scripts/generate-template.mjs`
+- **入力**: プロジェクトルートの `CLAUDE.md`
+- **出力**: `packages/cli/presets/default/CLAUDE.md.template`
+- **処理**:
+  1. `@einja:excluded` マーカー内を除去（L53-56）
+  2. `pnpm install` 等のコマンドをプレースホルダー（`{{INSTALL_COMMAND}}`等）に変換（L25-35, L62-69）
+
+#### Step 2: プリセットファイルコピー + マーカーバリデーション
+- **スクリプト**: `packages/cli/scripts/copy-presets.mjs`
+- **処理順序**:
+  1. `docs/einja/` 配下のマーカーバリデーション（L303-317）
+  2. ディレクトリマッピングに基づくコピー（L47-122）
+  3. 単一ファイルのコピー（L125-156）
+  4. シンボリックリンク情報の `symlinks.json` 出力（L284-295）
+
+### 1.2 `create-einja-app` テンプレート更新
+
+- **スクリプト**: `scripts/_template-update.ts`（ルート）
+- **出力先**: `packages/create-einja-app/templates/default/`
+- **処理**:
+  1. `.templateignore` でフィルタリング（L93-103）
+  2. `README.md` の `@einja:excluded` マーカー除去（L173-185）
+  3. `package.json` の `name` → `{{projectName}}`、`description` → `{{description}}`（L108-131）
+  4. `tsconfig.json` の `@repo/` → `{{packageName}}/`（L136-161）
+  5. `.ts/.tsx/.js/.jsx` の import文 `@repo/` → `{{packageName}}/`（L166-168）
+
+### 1.3 `@einja/dev-cli` プリセット更新（開発用）
+
+- **スクリプト**: `scripts/_cli-template-update.ts`
+- **実行**: `pnpm preset:update`（`packages/cli/package.json` L30）
+- **処理**: `FileCopier` クラスを使用してプロジェクト原本をCLIプリセットにコピー
+
+---
+
+## 2. ファイルマッピング
+
+### 2.1 `@einja/dev-cli` コピー対象（`copy-presets.mjs`）
+
+#### ディレクトリマッピング（L47-122）
+
+| 原本 | コピー先（`presets/default/` 配下） | 備考 |
+|------|--------------------------------------|------|
+| `.claude/agents/einja/` | `.claude/agents/einja/` | |
+| `.claude/commands/einja/` | `.claude/commands/einja/` | |
+| `.claude/skills/einja-*` | `.claude/skills/einja-*/` | 個別列挙（L62-101） |
+| `.claude/hooks/einja/` | `.claude/hooks/einja/` | `cleanParent: true`（L107） |
+| `docs/einja/` | `docs/einja/` | `memory/`, `cli/` を除外（L114） |
+| `scripts/` | `scripts/` | `_` プレフィックスのファイルはスキップ（L247-249） |
+
+#### 単一ファイルマッピング（L125-156）
+
+| 原本 | コピー先 | 必須 |
+|------|---------|------|
+| `.claude/settings.json` | `.claude/settings.json` | Yes |
+| `.mcp.json` | `.mcp.json` | No |
+| `docs/einja/cli/preset.yaml` | `preset.yaml` | Yes |
+| `.envrc` | `.envrc` | Yes |
+| `.vscode/settings.json` | `.vscode/settings.json` | No |
+
+#### 特殊変換
+
+| 原本 | コピー先 | 変換内容 |
+|------|---------|---------|
+| `CLAUDE.md` | `CLAUDE.md.template` | `@einja:excluded` 除去 + プレースホルダー変換（`generate-template.mjs`） |
+
+### 2.2 `FileCopier` クラスのマッピング（`file-copier.ts`）
+
+**ファイル**: `packages/cli/src/lib/preset-update/file-copier.ts`
+
+`FileCopier` は `einja sync` / `preset:update` で使用される。`copy-presets.mjs`（prebuild）とは別のコピーロジック。
+
+ディレクトリマッピング（L44-85）:
+
+| source | destination | category |
+|--------|------------|----------|
+| `.claude/commands` | `.claude/commands/einja` | commands |
+| `.claude/agents` | `.claude/agents/einja` | agents |
+| `.claude/skills` | `.claude/skills` | skills |
+| `.claude/hooks` | `.claude/hooks` | hooks |
+| `docs/einja/steering` | `docs/einja/steering` | docs |
+| `docs/einja/templates` | `docs/einja/templates` | docs |
+| `docs/einja/instructions` | `docs/einja/instructions` | docs |
+| `docs/einja/example` | `docs/einja/example` | docs |
+
+単一ファイルマッピング（L92-104）:
+
+| source | destination | category |
+|--------|------------|----------|
+| `.envrc` | `.envrc` | env |
+| `.vscode/settings.json` | `.vscode/settings.json` | tools |
+| `package.json`（ルート） | `package.json` | root-config |
+
+---
+
+## 3. コピー対象フィルタ
+
+### 3.1 Skills のプレフィックスフィルタ
+
+**ファイル**: `packages/cli/src/lib/preset-update/file-copier.ts` L194-195
+
+```typescript
+// skillsカテゴリの場合、einja-/_einja-プレフィックスでフィルタリング
+const prefixFilter = mapping.category === "skills" ? ["einja-", "_einja-"] : undefined;
+```
+
+`.claude/skills/` 配下のトップレベルディレクトリのうち、**`einja-` または `_einja-` で始まるもの**が配布対象。
+
+- **配布される**: `einja-task-commit/`, `einja-skill-creator/`, `_einja-project-overview/` 等
+- **配布されない**: `cli-package-specs/`（このSkill自体）、その他プレフィックスなしのSkill
+
+`copy-presets.mjs` ではディレクトリを動的スキャンし、`einja-*` / `_einja-*` パターンにマッチするものを個別エントリとしてコピーする。
+
+### 3.2 `_` プレフィックスフィルタ
+
+- `copy-presets.mjs` L247-249: `_` で始まるファイル名はスキップ
+- `file-copier.ts` L291: `_` で始まるファイル名はスキップ
+
+### 3.3 隠しファイルフィルタ（`file-copier.ts` のみ）
+
+- L303: `.` で始まるファイル名はスキップ（単一ファイルマッピングで明示されたものを除く）
+
+---
+
+## 4. マーカー仕様
+
+**詳細仕様書**: `packages/cli/docs/MARKER_SPECIFICATION.md`
+**実装**: `packages/cli/src/lib/sync/marker-processor.ts`
+
+### 4.1 `@einja:excluded`
+
+テンプレート生成時に**セクション全体を除去**するマーカー。
+
+```markdown
+<!-- @einja:excluded:start -->
+このセクション内容はテンプレートには含まれない
+<!-- @einja:excluded:end -->
+```
+
+- `generate-template.mjs` L53-56: CLAUDE.md → CLAUDE.md.template 変換時に除去
+- `template-update.ts` L56-67: create-einja-app テンプレート（README.md等）で除去
+- `_template-update.ts` L173-185: 同上
+
+### 4.2 `@einja:managed`
+
+`einja sync` 実行時に**常にテンプレート版で上書き**されるセクション。
+
+```markdown
+<!-- @einja:managed:start -->
+共通ルール（sync時に最新版で上書き）
+<!-- @einja:managed:end -->
+```
+
+- ID属性はオプション: `<!-- @einja:managed:start id="section-a" -->`
+- `marker-processor.ts` L16-17: パース用正規表現
+
+### 4.3 `@einja:project-private`
+
+`einja sync` 実行時に**初回のみ追加、以降はユーザー編集を保持**するセクション。
+
+```markdown
+<!-- @einja:project-private:start id="commit-rules-project" -->
+プロジェクト固有の設定（ユーザーが自由に編集）
+<!-- @einja:project-private:end -->
+```
+
+- **ID属性は必須**（`marker-processor.ts` L174-181 でバリデーション）
+- レガシー `@einja:seed` マーカーとの後方互換あり（L44-53, L303-307）
+
+### 4.4 マーカーバリデーション
+
+`packages/cli/scripts/validate-markers.mjs` がビルド時（`copy-presets.mjs` L303-317 から呼び出し）に実行。
+
+| チェック項目 | エラータイプ |
+|------------|------------|
+| start/end ペア一致 | `unpaired_start` / `unpaired_end` |
+| ネスト禁止 | `nested` |
+| project-private に ID 必須 | `project_private_without_id` |
+| ID 重複禁止 | `duplicate_id` |
+
+### 4.5 JSON マージ仕様
+
+**実装**: `packages/cli/src/lib/sync/json-processor.ts`
+**設定**: `.einja-sync.json` の `jsonPaths` フィールド
+
+#### マージモード（ブラックリスト方式）
+
+| モード | 動作 | 用途 |
+|--------|------|------|
+| `managed` | テンプレート値で強制上書き | テンプレートが完全管理するセクション |
+| `project-private` | 完全除外（テンプレートから追加・更新しない） | プロジェクト固有のセクション |
+| デフォルト | base/local/templateの3方向マージ | 上記以外の全パス |
+
+#### ネスト指定
+
+パスはドット区切りでネスト指定可能。`deepMergeWithPaths` の再帰により
+各レベルで jsonPaths チェックが行われる。
+
+例: `"project-private": { "package.json": ["devDependencies.@types/node"] }`
+→ devDependencies 全体は3方向マージ、@types/node のみ除外
+
+#### 設定例
+
+```
+jsonPaths:
+  managed: { ".claude/settings.json": ["plansDirectory"] }
+  project-private: { "package.json": ["name", "version", "private", "workspaces"] }
+```
+
+→ plansDirectory はテンプレート強制上書き
+→ name, version 等は完全除外
+→ scripts, devDependencies 等は3方向マージ
+
+#### base スナップショット
+
+3方向マージには前回sync時のテンプレート内容（base）が必要。
+`.einja-sync.json` の各ファイルメタデータに `baseContent` として保存。
+初回sync（base なし）はローカル優先 + テンプレート新規キーのみ追加。
+
+#### コンフリクト
+
+両方が同じキーを異なる値に変更した場合:
+- ローカル値を保持（安全側）
+- コンソールに警告出力
+- `mergeJson` の戻り値 `conflicts` 配列で呼び出し元にも通知
+
+---
+
+## 5. `post-setup.ts` 処理フロー
+
+**ファイル**: `packages/create-einja-app/src/generators/post-setup.ts`
+
+`create-einja-app` でプロジェクト生成後に実行されるセットアップフロー。
+
+| Step | 処理 | 行番号 |
+|------|------|--------|
+| 0 | 初回セットアップ（`scripts/init.sh` 実行: Volta/Node.js/pnpm/direnv） | L57-64 |
+| 1 | 依存関係インストール（`pnpm install`） + Prismaクライアント生成（`pnpm db:generate`） | L68-87 |
+| 2 | 秘密鍵の自動ローテーション（`pnpm env:rotate-secrets --all --non-interactive`） | L90-99 |
+| 3 | Git初期化（`git init` → `git add .` → `git commit`） | L102-113 |
+| 4 | `@einja/dev-cli` 初期化（`npx @einja/dev-cli@latest init --force --no-backup`、`config.setupEinjaCli` が true の場合のみ） | L116-125 |
+| 5 | 完了メッセージ表示 | L128 |
+
+---
+
+## 6. `setup-dev.ts` 処理フロー
+
+**ファイル**: `scripts/setup-dev.ts`
+
+既存プロジェクトの開発環境セットアップスクリプト。
+
+| Step | 処理 | 行番号 |
+|------|------|--------|
+| 1 | Volta インストール確認 | L158-191 |
+| 2 | Volta シェル設定（`VOLTA_FEATURE_PNPM`） | L194-213 |
+| 3 | Node.js / pnpm インストール（`volta install`） | L216-249 |
+| 4 | direnv インストール確認（macOS: `brew install direnv`） | L324-355 |
+| 5 | シェル設定（`direnv hook` を rc ファイルに追加） | L358-376 |
+| 6 | dotenvx インストール | L379-419 |
+| 7 | `.env` ファイル作成（`.env.local` から復号、worktree 対応） | L422-517 |
+| 8 | `.env.personal` 作成 + `GITHUB_TOKEN` 対話設定 | L519-585 |
+| 9 | direnv 有効化（`direnv allow`） | L588-594 |
+| 10 | データベース起動（`docker-compose up -d postgres`） | L597-625 |
+| 11 | データベース初期化（`pnpm db:generate` + `pnpm db:push`） | L610-613 |
+
+worktree 環境では `.env.keys` をメインリポジトリから自動コピーする機能あり（L45-67, L73-90）。

package/templates/default/.einja-sync.json

@@ -3,7 +3,7 @@
   "lastSync": "2026-01-04T16:21:21.138Z",
   "templateVersion": "0.1.0",
   "files": {
-    ".claude/commands/einja/update-docs-by-task-specs.md": {
+    ".claude/commands/einja/update-docs-by-issue-specs.md": {
       "hash": "6c09bb6748134849e8de535d6cdb382bfe0aeb0a3fb19730e1c7708ceaa283bc",
       "syncedAt": "2026-01-04T16:21:21.151Z"
     },

package/templates/default/.github/release.yml

@@ -0,0 +1,10 @@
+changelog:
+  exclude:
+    labels: ["dependencies", "skip-changelog"]
+  categories:
+    - title: "New Features"
+      labels: ["enhancement", "feature"]
+    - title: "Bug Fixes"
+      labels: ["bug", "fix"]
+    - title: "Other Changes"
+      labels: ["*"]

package/templates/default/.github/workflows/changeset-status.yml

@@ -0,0 +1,60 @@
+name: Changeset Status
+
+on:
+  pull_request:
+    branches: [main, staging]
+    types: [opened, synchronize, reopened]
+
+jobs:
+  changeset-check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Check for changesets
+        id: check
+        run: |
+          COUNT=$(ls .changeset/*.md 2>/dev/null | grep -cv README.md || echo 0)
+          echo "count=$COUNT" >> $GITHUB_OUTPUT
+          echo "has_changesets=$([[ $COUNT -gt 0 ]] && echo true || echo false)" >> $GITHUB_OUTPUT
+
+      - name: Comment on PR
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const count = parseInt('${{ steps.check.outputs.count }}');
+            const hasChangesets = '${{ steps.check.outputs.has_changesets }}' === 'true';
+            const marker = '<!-- changeset-status -->';
+
+            let body;
+            if (hasChangesets) {
+              body = `${marker}\n### ✅ Changeset detected\n\nThis PR includes **${count}** changeset(s). A release will be created when merged.`;
+            } else {
+              body = `${marker}\n### ⚠️ No changeset found\n\nThis PR does not include a changeset. If this PR includes user-facing changes, please run:\n\n\`\`\`bash\npnpm changeset\n\`\`\`\n\nIf this change doesn't need a release (docs, CI, config), you can ignore this message.`;
+            }
+
+            // Find existing comment
+            const comments = await github.rest.issues.listComments({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+            });
+            const existing = comments.data.find(c => c.body.includes(marker));
+
+            if (existing) {
+              await github.rest.issues.updateComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                comment_id: existing.id,
+                body,
+              });
+            } else {
+              await github.rest.issues.createComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: context.issue.number,
+                body,
+              });
+            }