create-einja-app 0.3.0 → 0.3.2

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` でコミット分割が正しいこと

package/templates/default/docs/plans/cheerful-wiggling-ullman.md

@@ -0,0 +1,164 @@
+# einja sync: 孤児ファイル検出・削除機能
+
+## Context
+
+`einja sync` はテンプレートからプロジェクトへファイルを同期するが、テンプレート側でファイルが削除されても利用者側のファイルはそのまま残る。`.einja-sync.json` に過去の同期記録があるため、「メタデータにあるがテンプレートにないファイル」＝孤児として検出可能。
+
+## 方針
+
+- `sync` 実行時に常に孤児を検出・警告表示
+- `--clean` フラグで実際に削除（確認プロンプト + バックアップ付き）
+- 既存のUXパターン（dry-run, JSON出力, --yes, --no-backup）に完全準拠
+
+## 変更対象ファイル
+
+| ファイル | 変更内容 |
+|---------|---------|
+| `packages/cli/src/types/index.ts` | `SyncOptions` に `clean?: boolean` 追加 |
+| `packages/cli/src/types/sync.ts` | `OrphanFile`, `OrphanReport` 型追加、`JsonOutput.summary` に `orphansDetected?`, `orphansDeleted?` 追加、`JsonOutput.orphans?` 追加 |
+| `packages/cli/src/lib/sync/orphan-cleaner.ts` | **新規**: 孤児検出・レポート生成クラス |
+| `packages/cli/src/lib/sync/metadata-manager.ts` | `removeFiles()` メソッド追加 |
+| `packages/cli/src/commands/sync.ts` | 孤児検出→警告表示→`--clean`時の削除処理を統合 |
+| `packages/cli/src/cli.ts` | `--clean` オプション追加 |
+| `packages/cli/src/lib/sync/orphan-cleaner.test.ts` | **新規**: OrphanCleanerのユニットテスト |
+| `packages/cli/src/lib/sync/metadata-manager.test.ts` | `removeFiles` テスト追加 |
+
+## 実装ステップ
+
+### Step 1: 型定義追加
+
+**`types/index.ts`** — `SyncOptions` に追加:
+```typescript
+clean?: boolean;
+```
+
+**`types/sync.ts`** — 型追加:
+```typescript
+export interface OrphanFile {
+  path: string;
+  category: string | null;
+  exists: boolean;  // ディスク上に実在するか
+}
+
+export interface OrphanReport {
+  hasOrphans: boolean;
+  orphans: OrphanFile[];
+  total: number;
+  existingCount: number;  // ディスク上に実在する数
+}
+```
+
+`JsonOutput.summary` に `orphansDetected?`, `orphansDeleted?` を追加。`JsonOutput` に `orphans?: OrphanFile[]` を追加。
+
+### Step 2: OrphanCleaner クラス（新規）
+
+**`lib/sync/orphan-cleaner.ts`** — 既存の `ConflictReporter` と同じ設計パターン:
+
+```typescript
+export class OrphanCleaner {
+  constructor(private projectRoot: string, private fileFilter: FileFilter) {}
+
+  async detectOrphans(
+    metadata: SyncMetadata,
+    currentTemplateFiles: string[],
+    categories?: string[]
+  ): Promise<OrphanFile[]>
+  // metadata.files のキー vs currentTemplateFiles を比較
+  // カテゴリフィルタ: fileFilter.getCategoryFromPath() で判定
+  // fs.pathExists でディスク実在チェック
+
+  createReport(orphans: OrphanFile[]): OrphanReport
+
+  formatReport(report: OrphanReport): string
+  // 例: "  🗑️  .claude/skills/einja-old/SKILL.md (存在)"
+
+  formatHelpMessage(): string
+  // "💡 削除するには --clean オプションを使用してください"
+}
+```
+
+### Step 3: MetadataManager 拡張
+
+**`lib/sync/metadata-manager.ts`** に追加:
+```typescript
+removeFiles(metadata: SyncMetadata, filePaths: string[]): SyncMetadata
+// metadata.files から指定パスのエントリを削除して返す
+```
+
+### Step 4: CLI オプション追加
+
+**`cli.ts`** の sync コマンドに追加:
+```typescript
+.option("--clean", "テンプレートから削除されたファイル（孤児）を削除")
+```
+
+### Step 5: sync.ts への統合
+
+既存フローへの挿入位置:
+
+```
+ 1. メタデータ読み込み
+ 2. 同期対象スキャン (targets)
+ 3. 差分計算
+ 4. ★ 孤児検出（常に実行）
+ 5. dry-run モード
+    - 既存の差分表示
+    - ★ 孤児レポート表示
+ 6. 確認プロンプト
+ 7. バックアップ作成
+ 8. ファイルマージ処理
+ 9. ★ 孤児削除処理（--clean 時のみ）
+    - 確認プロンプト（デフォルトNo、--yes でスキップ）
+    - バックアップ作成
+    - ファイル削除
+    - メタデータから削除
+10. メタデータ保存
+11. 結果出力
+    - ★ 孤児レポート（--clean 無しでも警告表示）
+    - ★ JSON出力に orphans フィールド追加
+12. 依存関係チェック
+```
+
+### Step 6: テスト
+
+**orphan-cleaner.test.ts（新規）:**
+- メタデータにあるがテンプレートにないファイルを検出
+- カテゴリフィルタが正しく適用される
+- ディスク実在チェックが正しい
+- レポートフォーマットが正しい
+
+**metadata-manager.test.ts（追加）:**
+- `removeFiles` で複数ファイルが正しく削除される
+
+## UX例
+
+### 通常 sync（孤児あり、--clean なし）
+```
+✅ 同期完了!
+  - 成功: 3ファイル
+  - スキップ: 12ファイル
+
+⚠️  孤児ファイルが検出されました:
+  🗑️  .claude/skills/einja-old/SKILL.md
+  🗑️  docs/einja/deprecated.md
+
+💡 削除するには --clean オプションを使用してください
+```
+
+### `--clean` 実行時
+```
+⚠️  以下の孤児ファイルを削除します:
+  🗑️  .claude/skills/einja-old/SKILL.md
+  🗑️  docs/einja/deprecated.md
+
+? 2ファイルを削除します。続行しますか? (y/N) y
+
+  - 孤児削除: 2ファイル
+```
+
+## 検証方法
+
+1. `pnpm -F @einja/dev-cli test` — 全テスト通過
+2. `pnpm -F @einja/dev-cli typecheck` — 型チェック通過
+3. `pnpm -F @einja/dev-cli lint` — lint通過
+4. 手動テスト: `.einja-sync.json` に存在しないファイルエントリを追加 → `einja sync --dry-run` で孤児検出 → `einja sync --clean --yes` で削除確認

package/templates/default/docs/plans/compiled-humming-cherny.md

@@ -0,0 +1,94 @@
+# Plan: project-privateセクションの簡素化
+
+## Context
+
+project-privateセクションの冗長な形式を簡素化する。現在の形式：
+
+```markdown
+---
+
+<!-- @einja:project-private:start id="xxx" -->
+## プロジェクト固有の設定
+
+<!-- このセクションはプロジェクト固有の内容を追記する場所です -->
+<!-- einja syncで上書きされません -->
+<!-- @einja:project-private:end -->
+```
+
+新しい形式：
+
+```markdown
+<!-- @einja:project-private:start id="xxx" -->
+<!-- プロジェクト固有の情報を記入 -->
+<!-- @einja:project-private:end -->
+```
+
+変更点：
+1. 直前の `---` 罫線を削除
+2. `## プロジェクト固有の設定` 見出しを削除
+3. 空行 + 2行コメントを1行コメントに統合
+
+## 互換性
+
+CLIの `marker-processor.ts` はstart/endタグのみでパースするため、中身のコメント変更は完全に互換。
+
+## 対象ファイル
+
+### 一括置換対象（63ファイル）
+
+| カテゴリ | ファイル数 |
+|---------|-----------|
+| `.claude/agents/einja/` | 16 |
+| `.claude/commands/einja/` | 7 |
+| `.claude/skills/einja-*/SKILL.md` | 13 |
+| `docs/einja/steering/` | 20 |
+| `docs/einja/instructions/` | 7 |
+
+### 対象外
+
+| カテゴリ | 理由 |
+|---------|------|
+| `CLAUDE.md` | 修正済み |
+| `docs/einja/memory/` | ファイル全体がproject-private、見出しは意味あるコンテンツ |
+| `packages/cli/` | ソースコード・テスト（文字列リテラル・テストデータ） |
+| `packages/create-einja-app/` | 同上 |
+| `docs/plans/` | 過去のplan（参照用） |
+| `.claude/skills/einja-skill-creator/scripts/init_skill.py` | 説明用コードブロック内（短い形式で既にOK） |
+| `.claude/skills/einja-skill-creator/SKILL.md` | 説明用コードブロック + 自身のproject-private |
+| `.claude/skills/einja-coding-standards/references/testing-strategy.md` | 確認が必要 |
+
+## 実装手順
+
+### Step 1: sedで一括置換
+
+2つのパターンに対応：
+
+**パターンA**: `---` + 空行 + `---` + 空行 + project-private（1ファイル: `frontend-implement.md`）
+**パターンB**: `---` + 空行 + project-private（約62ファイル）
+
+両パターンをカバーするPerl正規表現で一括処理：
+
+```bash
+# .claude/ と docs/einja/ 配下の .md ファイルを対象に、
+# "---\n\n" (1つまたは2つ) + 冗長なproject-private を簡素な形式に置換
+find .claude/agents .claude/commands .claude/skills docs/einja/steering docs/einja/instructions \
+  -name '*.md' -exec perl -0777 -pi -e '
+  s/\n---\n(\n---\n)?\n<!-- @einja:project-private:start id="([^"]+)" -->\n## プロジェクト固有の設定\n\n<!-- このセクションはプロジェクト固有の内容を追記する場所です -->\n<!-- einja syncで上書きされません -->\n<!-- @einja:project-private:end -->/\n<!-- \@einja:project-private:start id="$2" -->\n<!-- プロジェクト固有の情報を記入 -->\n<!-- \@einja:project-private:end -->/g' {} +
+```
+
+### Step 2: SKILL.md内のドキュメント例も更新
+
+`einja-skill-creator/SKILL.md` 内の説明用コードブロック部分は手動で確認・更新。
+
+### Step 3: 検証
+
+```bash
+# 旧形式が残っていないことを確認
+grep -r "## プロジェクト固有の設定" .claude/ docs/einja/steering/ docs/einja/instructions/ --include="*.md"
+
+# 新形式の件数を確認（63ファイル程度）
+grep -r "<!-- プロジェクト固有の情報を記入 -->" .claude/ docs/einja/ --include="*.md" | wc -l
+
+# テスト実行（marker-processor関連）
+cd packages/cli && pnpm test -- marker-processor
+```

package/templates/default/docs/plans/dapper-launching-lynx.md

@@ -0,0 +1,81 @@
+# CLAUDE.md プロジェクト概要セクションの改善
+
+## Context
+
+CLAUDE.mdの「プロジェクト概要」セクションが、ファイルパス直接参照と頻出コマンドのハードコード記述になっている。Skill名ベースの参照に統一し、頻出コマンドの重複管理を解消する。
+
+### 現状の問題点
+
+1. **ファイルパス参照** → パス変更時に壊れる、Skill仕組みと不整合
+2. **頻出コマンド** → CLAUDE.mdにハードコード。project-overviewにまとめれば一元管理できる
+
+## 変更内容
+
+### 1. CLAUDE.md「プロジェクト概要」セクション（L106-119）
+
+**Before:**
+```markdown
+## プロジェクト概要
+
+Turborepoモノレポ構成（pnpm workspaces）。詳細は以下を参照:
+- `.claude/skills/einja-project-overview/SKILL.md` - 構成、技術スタック
+- `.claude/skills/einja-coding-standards/SKILL.md` - コーディング規約、インポートパス規約
+- `.claude/skills/einja-infra-maintenance/SKILL.md` - 開発環境セットアップ、サーバー管理
+
+### 頻出コマンド
+- `pnpm dev:bg` / `pnpm dev:stop` - 開発サーバー起動/停止
+- `pnpm build` - プロダクションビルド
+- `pnpm lint:fix && pnpm format:fix` - コード自動修正
+- `pnpm typecheck` - 型チェック
+- `pnpm test` - テスト実行
+- `pnpm prepush` - プッシュ前チェック（lint + typecheck + test）
+```
+
+**After:**
+```markdown
+## プロジェクト概要
+
+Turborepoモノレポ構成（pnpm workspaces）。詳細が必要な場合は以下のSkillを参照:
+- `einja-project-overview` - 構成、技術スタック、頻出コマンド
+- `einja-coding-standards` - コーディング規約、インポートパス規約
+- `einja-infra-maintenance` - 開発環境セットアップ、サーバー管理
+```
+
+→ 頻出コマンドをCLAUDE.mdから削除し、project-overview Skillに移動
+
+### 2. einja-project-overview SKILL.md に頻出コマンドを追加
+
+**追加内容:**
+```markdown
+## 頻出コマンド
+
+- `pnpm dev:bg` / `pnpm dev:stop` - 開発サーバー起動/停止
+- `pnpm build` - プロダクションビルド
+- `pnpm lint:fix && pnpm format:fix` - コード自動修正
+- `pnpm typecheck` - 型チェック
+- `pnpm test` - テスト実行
+- `pnpm prepush` - プッシュ前チェック（lint + typecheck + test）
+```
+
+### トレードオフ
+
+| 観点 | 現状（CLAUDE.md直書き） | 変更後（Skill参照） |
+|------|----------------------|-------------------|
+| 即座に参照可能か | 常にシステムプロンプトに含まれる | Skillロード時に参照可能 |
+| 一元管理 | CLAUDE.mdとSkillで二重管理リスク | project-overviewが Single Source of Truth |
+| CLAUDE.mdの簡潔さ | 14行占有 | 4行に短縮（-10行） |
+
+頻出コマンドは実作業時にSkillをロードすれば十分。CLAUDE.mdはポインタに徹する方が設計上正しい。
+
+## 対象ファイル
+
+| ファイル | 変更内容 |
+|---------|---------|
+| `CLAUDE.md` (L106-119) | Skill名参照に変更、頻出コマンド削除 |
+| `.claude/skills/einja-project-overview/SKILL.md` | 頻出コマンドセクション追加 |
+
+## 検証
+
+- `CLAUDE.md` でファイルパス参照が残っていないこと（Grepで確認）
+- `einja-project-overview/SKILL.md` に頻出コマンドが含まれること
+- `pnpm prepush` が通ること（CLAUDE.mdはlint対象外だが念のため）