create-einja-app 0.3.1 → 0.3.3

package/templates/default/docs/plans/ancient-watching-otter.md

@@ -0,0 +1,152 @@
+# Plan: OrbStack推奨統一 + CLAUDE.md修正 + GitHub自動セットアップ + パッケージ仕様Skill
+
+## Context
+
+1. `create-einja-app` がGitHubリポジトリの作成・設定を行っていない
+2. Docker環境でOrbStackを推奨に統一したい
+3. CLAUDE.mdの「マネージドディレクトリ（編集禁止）」は下流リポジトリ向けルールであり、このテンプレートリポジトリ（原本）では `docs/einja/` は編集可能
+4. 2パッケージ（`@einja/dev-cli`, `create-einja-app`）のビルド仕様を毎回確認するのが手間なので、Skillとして参照できるようにする
+
+---
+
+## TODO-0: パッケージ仕様参照Skill作成
+
+### 目的
+`@einja/dev-cli` と `create-einja-app` の2パッケージのビルド・テンプレート仕様を、既存ドキュメント・コードへの参照として1箇所にまとめる。配布しない（このリポジトリ専用）。
+
+### 作成ファイル
+- `.claude/skills/cli-package-specs/SKILL.md`
+
+### 命名理由
+`einja-` プレフィックスなし → `file-copier.ts:195` のフィルタにより `presets/default/` にコピーされない
+
+### 内容（参照ベース）
+- 2パッケージの概要と役割
+- ビルドパイプライン
+  - `packages/cli/scripts/generate-template.mjs`: CLAUDE.md → CLAUDE.md.template（`@einja:excluded` 除去 + プレースホルダー変換）
+  - `packages/create-einja-app/scripts/template-update.ts`: テンプレートファイルコピー（CLAUDE.mdは無変換でコピー）
+  - `scripts/_cli-template-update.ts`: CLIプリセット更新（`FileCopier` 経由、CLAUDE.mdは対象外）
+  - `scripts/_template-update.ts`: create-einja-appテンプレート更新（README.mdのみexcluded除去）
+- ファイルマッピング（CLAUDE.md「CLIパッケージの二重管理禁止」テーブル参照）
+- コピー対象フィルタ: `.claude/skills/einja-*/` のみ配布（`file-copier.ts:195`）
+- マーカー仕様: `@einja:excluded`, `@einja:project-private`, `@einja:managed`
+- `post-setup.ts` の処理フロー参照
+- `setup-dev.ts` の処理フロー参照
+
+---
+
+## TODO-1: CLAUDE.md excludedセクション修正
+
+### 変更方針
+マネージドディレクトリセクション自体は残す（下流リポジトリ向けに正しいルール）。`@einja:excluded` ブロック内に以下2点を追加。
+
+### 変更内容（`CLAUDE.md` excludedセクション内）
+
+#### 1. パッケージ仕様Skillの参照指示を追加
+
+```markdown
+### パッケージビルド仕様（テンプレートリポジトリ限定）
+
+`@einja/dev-cli` と `create-einja-app` の2パッケージのビルド・テンプレート仕様については、以下のSkillを参照すること:
+
+`.claude/skills/cli-package-specs/SKILL.md`
+```
+
+#### 2. マネージドディレクトリのオーバーライド注記を追加
+
+```markdown
+### マネージドディレクトリの編集について（テンプレートリポジトリ限定）
+
+このリポジトリは `docs/einja/` の**原本（Single Source of Truth）**である。
+上記「マネージドディレクトリ（編集禁止）」ルールは下流リポジトリ（create-einja-appで生成されたプロジェクト）向けであり、
+**このリポジトリでは `docs/einja/` 配下の全ファイルを編集してよい**。
+変更はビルド時に `presets/default/` へ自動コピーされる。
+```
+
+### 対象ファイル
+- `CLAUDE.md`（excludedセクション内 L218付近）
+
+---
+
+## TODO-2: OrbStack推奨に統一
+
+### 2-1. `scripts/setup-dev.ts` 修正（L621-625）
+
+Docker未インストール時のメッセージをOS別に分岐し、macOSではOrbStack推奨:
+
+```typescript
+} else {
+    warn("Dockerがインストールされていません");
+    const platform = getPlatform();
+    if (platform === "macos") {
+        console.log(colors.yellow("  OrbStack（Docker互換の軽量ツール）のインストールを推奨します:"));
+        console.log(colors.cyan("    brew install orbstack"));
+        console.log(colors.gray("  または: https://orbstack.dev/"));
+    } else if (platform === "windows") {
+        console.log(colors.yellow("  Dockerをインストールしてください:"));
+        console.log(colors.gray("    https://docs.docker.com/desktop/install/windows-install/"));
+    } else {
+        console.log(colors.yellow("  Docker Engineをインストールしてください:"));
+        console.log(colors.gray("    https://docs.docker.com/engine/install/"));
+    }
+    console.log(colors.gray("  インストール後、以下を実行してください:"));
+    console.log(colors.gray("    docker-compose up -d postgres"));
+    console.log(colors.gray("    pnpm db:generate && pnpm db:push"));
+}
+```
+
+### 2-2. `docs/einja/instructions/deployment-setup.md` 修正（L38）
+
+```
+Before: | Docker | [Docker Desktop](https://www.docker.com/products/docker-desktop/) | PostgreSQL実行 |
+After:  | Docker | macOS: [OrbStack](https://orbstack.dev/)（推奨）/ その他: [Docker Engine](https://docs.docker.com/engine/install/) | PostgreSQL実行 |
+```
+
+### 2-3. `docs/einja/instructions/local-server-environment-and-worktree.md` 修正（L62-63）
+
+```
+Before:
+  - macOS: [Docker Desktop for Mac](https://docs.docker.com/desktop/install/mac-install/)
+  - Windows: [Docker Desktop for Windows](https://docs.docker.com/desktop/install/windows-install/)
+
+After:
+  - macOS: [OrbStack](https://orbstack.dev/)（推奨。`brew install orbstack`）
+  - Windows: [Docker Desktop for Windows](https://docs.docker.com/desktop/install/windows-install/)
+```
+
+### 対象ファイル
+- `scripts/setup-dev.ts` (L596-625)
+- `docs/einja/instructions/deployment-setup.md` (L38)
+- `docs/einja/instructions/local-server-environment-and-worktree.md` (L62-63)
+
+---
+
+## TODO-3: GitHub自動セットアップスクリプト作成
+
+### 概要
+`scripts/init-github.ts` を新規作成。`pnpm init:github` で実行。
+
+### 処理フロー
+1. `gh` CLIの存在確認（なければインストール案内して終了）
+2. `gh auth status` で認証確認
+3. `git remote get-url origin` でリモート有無確認
+4. リモートなし → org/repo名を対話入力（デフォルト: ディレクトリ名）→ `gh repo create`
+5. `git push -u origin main`
+6. Branch Protection設定（`gh api`）
+7. GitHub Secrets設定（`.env.keys` から読み取り → `gh secret set`）
+8. Environments作成（production, preview）
+
+### 対象ファイル
+- `scripts/init-github.ts`（新規）
+- `package.json`（`"init:github"` スクリプト追加）
+- `scripts/setup-dev.ts`（完了メッセージに `pnpm init:github` 案内追加）
+
+---
+
+## 検証方法
+
+1. **Skill**: `.claude/skills/cli-package-specs/SKILL.md` が存在し、参照先のファイルパスが正しいこと
+2. **CLAUDE.md**: excludedセクション内にオーバーライド注記があること
+3. **OrbStack**: `grep -r "Docker Desktop"` でsetup-dev.tsとdocs 2ファイルに残っていないこと
+4. **init-github.ts**: `pnpm init:github --help` が動作すること
+5. `pnpm prepush` が通ること

package/templates/default/docs/plans/bright-sauteeing-bumblebee.md

@@ -0,0 +1,30 @@
+# Plan: AskUserQuestion の選択肢に description 必須記載ルールを追加
+
+## Context
+AskUserQuestionの選択肢を提示する際、`label` だけでは判断材料が不足する。`description` フィールドに詳細説明・注意点・トレードオフを必ず記載するルールをCLAUDE.mdに追加し、パッケージ利用者全体に適用する。
+
+**仕様確認結果**: AskUserQuestionの選択肢フィールドは `label`（必須）、`description`（必須）、`markdown`（任意）の3つ。`note` フィールドは存在しない。
+
+## 変更内容
+
+### 対象ファイル
+- `CLAUDE.md` L163-166「提示形式」セクション
+
+### 修正内容
+「提示形式」セクションを以下に書き換え:
+
+```markdown
+### 提示形式
+- テーブル形式: 複数項目の比較
+- 番号付きリスト: 詳細説明が必要な場合
+- 推奨オプションには `（推奨）` と理由を付記
+
+### 選択肢の記述ルール
+- 各選択肢の `description` に**必ず詳細説明・注意点・補足**を記載する
+- トレードオフ、影響範囲、前提条件など判断に必要な情報を含める
+- ラベルだけで選択させない。ユーザーが十分な情報に基づいて判断できるようにする
+```
+
+## 検証
+- CLAUDE.mdの変更箇所をReadで確認
+- `presets/default/CLAUDE.md.template` はビルド時に自動生成されるため手動更新不要

package/templates/default/docs/plans/bright-stargazing-dawn.md

@@ -0,0 +1,87 @@
+# Plan: einja-team-exec SKILL.md 書き直し + skill-creator 参考URL規約追加
+
+## Context
+
+einja-team-exec SKILL.mdがサブエージェントの仕組みをベースに書かれていたが、Agent TeamsのTeammatesはサブエージェントとは完全に別アーキテクチャであることが判明。公式ドキュメント（https://code.claude.com/docs/en/agent-teams）に基づいて正しい仕様で書き直す。
+
+また、Skill作成時に参考にした公式ドキュメントやベースとなるSkillのURLをコメントとして記録する規約を、einja-skill-creatorにも追加する。
+
+### Teammates vs サブエージェントの根本的な違い
+
+| 項目 | Teammates | サブエージェント |
+|------|-----------|--------------|
+| 実体 | 独立したClaude Codeプロセス | メインセッション内の一時的な子プロセス |
+| 通信 | メンバー同士で直接メッセージ可能 | メインにのみ報告 |
+| spawn方法 | 自然言語プロンプトで役割指定 | `subagent_type`で指定 |
+| 特殊化 | general-purposeベース、プロンプトで専門化 | `.claude/agents/`のカスタム定義可能 |
+| コンテキスト | 各自独立したフルコンテキストウィンドウ | メインの指示を引き継ぎ |
+
+## 対象ファイル
+
+| ファイル | 操作 |
+|---------|------|
+| `.claude/skills/einja-team-exec/SKILL.md` | 全面書き直し |
+| `.claude/skills/einja-skill-creator/SKILL.md` | 参考URL規約の追加 |
+
+## 変更内容
+
+### 1. einja-team-exec/SKILL.md 書き直し
+
+**削除するもの:**
+- `subagent_type`に基づくチームメンバー選出ガイド（テーブル3つ + 編成例）
+- `TeamCreate`/`TaskCreate`/`TaskUpdate`等のサブエージェント用ツール呼び出し手順
+- サブエージェントの文脈で書かれたワークフロー全体
+
+**新しく書くもの:**
+- 概要: Teammatesは独立したClaude Codeインスタンスであること
+- spawn方法: 自然言語プロンプトで役割・指示を記述（`subagent_type`ではない）
+- spawn時のプロンプト設計ガイド: 役割・担当範囲・制約を明確に記述する方法
+- プロンプト例（公式ドキュメントのパターンに準拠）:
+  ```
+  Create an agent team for [タスク].
+  Spawn teammates:
+  - [役割1]: [担当範囲と指示]
+  - [役割2]: [担当範囲と指示]
+  ```
+- チームサイズの目安（公式: 3-5 teammates、5-6 tasks/teammate）
+- 通信: 直接メッセージ + 共有タスクリスト
+- ファイル競合回避（公式: 各teammateが異なるファイルを担当）
+- コミット管理（CLAUDE.mdのgit安全ルールはCLAUDE.md経由で自動適用）
+- 完了・シャットダウン手順
+- 参考ドキュメントURLをコメントで記載
+
+**参考URLコメント（SKILL.md冒頭、フロントマター直後）:**
+```markdown
+<!-- 参考: https://code.claude.com/docs/en/agent-teams -->
+```
+
+### 2. einja-skill-creator/SKILL.md 参考URL規約追加
+
+「SKILL.mdの作成」セクション内に以下の規約を追加:
+
+**追加箇所**: `#### 記述パターン` セクションの近辺、または「Skill記述ガイド」セクション内
+
+**追加内容**:
+```
+#### 参考ドキュメントの記録
+
+Skill作成時に参考にした公式ドキュメント、ベースとなるSkill、
+設計判断の根拠となった情報源をSKILL.md内にHTMLコメントで記載する。
+
+**記載箇所**: フロントマター（`---`）直後
+
+**フォーマット**:
+<!-- 参考: https://example.com/docs/feature -->
+<!-- ベース: .claude/skills/existing-skill/SKILL.md -->
+
+これにより、Skillの設計根拠を後から追跡でき、
+公式仕様の変更時に影響範囲を特定しやすくなる。
+```
+
+## 検証
+
+- [ ] SKILL.mdのフロントマターが正しいYAML形式であること
+- [ ] サブエージェント関連の記述（`subagent_type`、`TaskCreate`等）が残っていないこと
+- [ ] 公式ドキュメントの仕様と矛盾がないこと
+- [ ] 参考URLコメントがSKILL.mdに記載されていること
+- [ ] einja-skill-creatorに参考URL規約が追加されていること

package/templates/default/docs/plans/calm-stirring-bonbon.md

@@ -0,0 +1,196 @@
+# ガイドライン系Skill廃止 → docs一元管理
+
+## Context
+
+開発ガイドラインが `.claude/skills/` と `docs/einja/steering/` に分散している。
+api-development, backend-architecture, frontend-development は既に docs に実体があり Skill は薄いラッパー。
+coding-standards, component-design は Skill 内の `references/` に内容が埋め込まれている。
+playwright-mcp は SKILL.md 自体が内容。
+
+**目的**: `docs/einja/steering/` にガイドラインを一元管理し、6つの不要なSkillを廃止する。
+
+---
+
+## Step 1: docsファイルの作成（内容移動）
+
+### 1-1. `docs/einja/steering/development/coding-standards.md` 作成
+
+SKILL.md の本文（基本原則、クイックリファレンス、ツール設定）+ references/ 4ファイルを1つに統合。
+
+統合元:
+- `.claude/skills/einja-coding-standards/SKILL.md` (行6-132)
+- `.claude/skills/einja-coding-standards/references/typescript-rules.md`
+- `.claude/skills/einja-coding-standards/references/naming-conventions.md`
+- `.claude/skills/einja-coding-standards/references/prohibited-patterns.md`
+- `.claude/skills/einja-coding-standards/references/import-conventions.md`
+
+構成: SKILL.mdの概要・基本原則・クイックリファレンス → 各references を見出し付きセクションとして追加。
+`@einja:managed` マーカーを付与。
+
+### 1-2. `docs/einja/steering/development/component-design.md` 作成
+
+SKILL.md の本文 + references/ 3ファイルを1つに統合。
+
+統合元:
+- `.claude/skills/einja-component-design/SKILL.md` (行6-109)
+- `.claude/skills/einja-component-design/references/directory-structure.md`
+- `.claude/skills/einja-component-design/references/props-patterns.md`
+- `.claude/skills/einja-component-design/references/styling-guide.md`
+
+構成: SKILL.mdの概要・基本原則・クイックリファレンス → 各references を見出し付きセクションとして追加。
+`@einja:managed` マーカーを付与。
+
+### 1-3. `docs/einja/steering/development/playwright-guidelines.md` 作成
+
+統合元:
+- `.claude/skills/einja-playwright-mcp/SKILL.md` (全54行)
+
+`@einja:managed` マーカーを付与。
+
+---
+
+## Step 2: 参照元の更新
+
+### 2-1. `.claude/agents/einja/task/task-executer.md`
+
+**フロントマター**: skills から5つ削除
+```yaml
+skills:
+  - spec-context-loader
+  - general-context-loader
+```
+
+**本文 行110-126**: 実装種別テーブル + 詳細規約パスを docs 直接参照に変更
+```markdown
+#### 1.3 実装種別に応じたドキュメント参照
+
+実装種別に応じて、以下のドキュメントを参照すること:
+
+| 実装種別 | 参照ドキュメント |
+|---------|--------------|
+| **API実装** | `docs/einja/steering/development/api-development.md` |
+| **フロントエンド実装** | `docs/einja/steering/development/frontend-development.md` |
+| **バックエンド実装** | `docs/einja/steering/development/backend-architecture.md` |
+| **コード全般** | `docs/einja/steering/development/coding-standards.md` |
+| **コンポーネント設計** | `docs/einja/steering/development/component-design.md` |
+
+**詳細規約が必要な場合**（Readツールで上記ドキュメントの該当セクションを読み込み）
+```
+
+### 2-2. `.claude/skills/einja-project-overview/SKILL.md`
+
+行24-26 の関連Skillセクションを docs 参照に変更:
+```markdown
+## 関連ドキュメント
+
+- `docs/einja/steering/development/coding-standards.md` - コーディング規約（インポートパス規約含む）
+- [infra-maintenance](../einja-infra-maintenance/SKILL.md) - 開発環境セットアップ・サーバー管理
+- `docs/einja/steering/development/component-design.md` - コンポーネント設計ガイドライン
+```
+
+### 2-3. `.claude/skills/einja-skill-creator/SKILL.md`
+
+行420-421 の例示を更新:
+- `einja-coding-standards` → docs参照パスに変更、または例示そのものを別のSkillに差し替え
+
+### 2-4. `CLAUDE.md`
+
+プロジェクト概要セクションの `einja-coding-standards` 参照を docs パスに変更:
+```markdown
+- `einja-project-overview` - 構成、技術スタック、頻出コマンド
+- `docs/einja/steering/development/coding-standards.md` - コーディング規約、インポートパス規約
+- `einja-infra-maintenance` - 開発環境セットアップ、サーバー管理
+```
+
+### 2-5. `README.md`
+
+行411-412 のリンクを docs パスに変更:
+```markdown
+- [コーディング規約](./docs/einja/steering/development/coding-standards.md)
+- [コンポーネント設計ガイドライン](./docs/einja/steering/development/component-design.md)
+```
+
+### 2-6. `docs/einja/steering/README.md`
+
+開発ガイドテーブルに3ファイルを追加:
+```markdown
+| [コーディング規約](development/coding-standards.md) | TypeScript/React命名規則、禁止パターン、インポート規約 | 全開発者 |
+| [コンポーネント設計](development/component-design.md) | ディレクトリ構造、Props設計、スタイリング | フロントエンド開発者 |
+| [Playwright動作確認](development/playwright-guidelines.md) | 一時ファイル管理、ブラウザ設定 | QA、開発者 |
+```
+
+フロントエンド開発者の必読セクションにも追加。
+
+---
+
+## Step 3: Skillディレクトリの削除
+
+以下の6ディレクトリを削除:
+- `.claude/skills/einja-api-development/`
+- `.claude/skills/einja-backend-architecture/`
+- `.claude/skills/einja-frontend-development/`
+- `.claude/skills/einja-coding-standards/`
+- `.claude/skills/einja-component-design/`
+- `.claude/skills/einja-playwright-mcp/`
+
+---
+
+## Step 4: ビルドスクリプトの更新
+
+### `packages/cli/scripts/copy-presets.mjs`
+
+mappings 配列から以下の6エントリを削除（行61-89）:
+- einja-api-development (行61-65)
+- einja-backend-architecture (行66-70)
+- einja-coding-standards (行71-75)
+- einja-component-design (行76-80)
+- einja-frontend-development (行86-90)
+
+※ einja-playwright-mcp はこのファイルに含まれていないので変更不要。
+
+---
+
+## Step 5: presets/default の同期確認
+
+ビルドスクリプトでコピーされる `presets/default/` 配下の対応するディレクトリも削除:
+- `packages/cli/presets/default/.claude/skills/einja-api-development/`
+- `packages/cli/presets/default/.claude/skills/einja-backend-architecture/`
+- `packages/cli/presets/default/.claude/skills/einja-frontend-development/`
+- `packages/cli/presets/default/.claude/skills/einja-coding-standards/`
+- `packages/cli/presets/default/.claude/skills/einja-component-design/`
+
+※ これらは次回ビルド時に生成されなくなるが、既存のものは手動削除が必要。
+
+---
+
+## 検証
+
+1. `pnpm --filter @einja/dev-cli build` でビルドが通ること
+2. `pnpm prepush` (lint + typecheck + test) が通ること
+3. 削除した Skill への参照が残っていないこと: `grep -r "einja-coding-standards\|einja-component-design\|einja-api-development\|einja-frontend-development\|einja-backend-architecture\|einja-playwright-mcp" .claude/ docs/ README.md CLAUDE.md packages/cli/scripts/`
+4. 新しい docs ファイルが正しく配置されていること
+5. `docs/einja/steering/README.md` のリンクが有効であること
+
+---
+
+## 変更ファイルサマリー
+
+| 操作 | ファイル |
+|------|---------|
+| **新規作成** | `docs/einja/steering/development/coding-standards.md` |
+| **新規作成** | `docs/einja/steering/development/component-design.md` |
+| **新規作成** | `docs/einja/steering/development/playwright-guidelines.md` |
+| **編集** | `.claude/agents/einja/task/task-executer.md` |
+| **編集** | `.claude/skills/einja-project-overview/SKILL.md` |
+| **編集** | `.claude/skills/einja-skill-creator/SKILL.md` |
+| **編集** | `CLAUDE.md` |
+| **編集** | `README.md` |
+| **編集** | `docs/einja/steering/README.md` |
+| **編集** | `packages/cli/scripts/copy-presets.mjs` |
+| **削除** | `.claude/skills/einja-api-development/` (1ファイル) |
+| **削除** | `.claude/skills/einja-backend-architecture/` (1ファイル) |
+| **削除** | `.claude/skills/einja-frontend-development/` (1ファイル) |
+| **削除** | `.claude/skills/einja-coding-standards/` (5ファイル) |
+| **削除** | `.claude/skills/einja-component-design/` (4ファイル) |
+| **削除** | `.claude/skills/einja-playwright-mcp/` (1ファイル) |
+| **削除** | `packages/cli/presets/default/.claude/skills/` 対応5ディレクトリ |

package/templates/default/docs/plans/calm-watching-widget.md

@@ -0,0 +1,111 @@
+# コミット・プッシュ計画
+
+## Context
+
+前回のセッションで実施された大規模なSkillリファクタリング（`reference/` → `references/` リネーム、新Skill追加、CLAUDE.mdスリム化、CLIパッケージ更新等）の変更が未コミットの状態で残っている。これらを適切な粒度でコミットし、プッシュする。
+
+## 現状の問題点
+
+### ステージングの不整合（要修正）
+
+以下のファイルは staged では `reference/` → `references/` にリネーム済みだが、ディスク上で削除されている（シンボリックリンクだったファイル）:
+
+| ファイル | 状態 |
+|---------|------|
+| `einja-coding-standards/references/commit-rules.md` | ステージ済み(rename) → ディスク上削除 |
+| `einja-coding-standards/references/review-guidelines.md` | 同上 |
+| `einja-coding-standards/references/testing-strategy.md` | 同上 |
+| `einja-component-design/references/frontend-development.md` | 同上 |
+| `einja-component-design/references/testing-strategy.md` | 同上 |
+| `einja-task-commit/references/commit-rules.md` | 同上（ディレクトリごと不在） |
+| `einja-task-qa/references/acceptance-criteria-and-qa-guide.md` | 同上 |
+
+→ これらの**削除もステージして**コミットに含める必要がある
+
+### 未ステージの変更
+
+| ファイル | 内容 |
+|---------|------|
+| `.claude/settings.json` | `plansDirectory: "docs/plans"` 追加 |
+| `CLAUDE.md` | さらなるリファクタリング（役割定義の簡潔化、セクション再構成） |
+
+## コミット分割計画
+
+### コミット1: `refactor(skills): referenceディレクトリをreferencesにリネーム・不要シンボリックリンクを削除`
+
+**対象ファイル:**
+- `.claude/skills/einja-coding-standards/` - `reference/` → `references/` リネーム + SKILL.mdパス更新
+- `.claude/skills/einja-component-design/` - 同上
+- `.claude/skills/einja-task-commit/` - 同上
+- `.claude/skills/einja-task-qa/` - 同上
+- `.claude/skills/einja-task-spec-generator/` - 同上
+- `.claude/skills/einja-task-spec-validator/` - 同上
+- 削除済みシンボリックリンクファイル7件のステージング
+- 削除済みSkill: `einja-api-development/reference/`, `einja-backend-architecture/reference/`, `einja-frontend-development/reference/`
+- `.claude/agents/einja/task/task-executer.md` - パス参照更新
+
+### コミット2: `feat(skills): einja-project-overview・einja-skill-creator Skill新規作成`
+
+**対象ファイル:**
+- `.claude/skills/einja-project-overview/SKILL.md` (新規)
+- `.claude/skills/einja-skill-creator/SKILL.md` (新規)
+- `.claude/skills/einja-skill-creator/scripts/init_skill.py` (新規)
+- `.claude/skills/einja-skill-creator/scripts/package_skill.py` (新規)
+- `.claude/skills/einja-skill-creator/scripts/quick_validate.py` (新規)
+
+### コミット3: `feat(skills): import-conventions追加・infra-maintenance/task-qa Skill更新`
+
+**対象ファイル:**
+- `.claude/skills/einja-coding-standards/references/import-conventions.md` (新規)
+- `.claude/skills/einja-infra-maintenance/SKILL.md` (更新)
+- `.claude/skills/einja-task-qa/SKILL.md` (更新)
+
+### コミット4: `refactor: CLAUDE.mdをスリム化しSkillへ内容を移行`
+
+**対象ファイル:**
+- `CLAUDE.md` (ステージ済み + 未ステージ変更をまとめて)
+
+### コミット5: `feat(cli): references/ディレクトリ対応・syncフィルター更新`
+
+**対象ファイル:**
+- `packages/cli/scripts/copy-presets.mjs`
+- `packages/cli/src/lib/preset-update/file-copier.ts`
+- `packages/cli/src/lib/preset-update/file-copier.test.ts`
+- `packages/cli/src/lib/sync/category-validator.ts`
+- `packages/cli/src/lib/sync/category-validator.test.ts`
+- `packages/cli/src/lib/sync/file-filter.ts`
+- `packages/cli/src/lib/sync/file-filter.test.ts`
+- `packages/cli/docs/SYMLINK_ARCHITECTURE.md`
+- `packages/cli/README.md`
+- `packages/cli/docs/BUILD.md`
+
+### コミット6: `docs: 環境セットアップ・Neon CLIリファレンスの更新`
+
+**対象ファイル:**
+- `docs/einja/instructions/environment-setup.md`
+- `docs/einja/instructions/local-server-environment-and-worktree.md`
+- `docs/einja/instructions/neon-cli-reference.md`
+
+### コミット7: `chore: create-einja-appテンプレート更新・BUILD.md追加`
+
+**対象ファイル:**
+- `packages/create-einja-app/.templateignore`
+- `packages/create-einja-app/README.md`
+- `packages/create-einja-app/docs/BUILD.md` (新規)
+
+### コミット8: `chore: settings.jsonにplansDirectory追加`
+
+**対象ファイル:**
+- `.claude/settings.json`
+
+## 実行手順
+
+1. 現在のステージングを一旦全解除（`git restore --staged .`）
+2. 各コミットごとにファイルを選択的にステージ → コミット
+3. 全コミット完了後 `pnpm prepush` 実行
+4. 成功後 `git push`
+
+## 検証
+
+- `pnpm prepush`（lint + typecheck + test）がパスすること
+- `git log --oneline -8` でコミット分割が正しいこと