実行する分析:
  1. ディレクトリツリーの取得（深さ3階層まで）
  2. ファイル拡張子の集計
  3. 設定ファイルの特定（package.json, pyproject.toml, Cargo.toml, go.mod 等）
  4. エントリーポイントの特定（main, index, app, server 等）
  5. テストディレクトリの特定
  6. CI/CD設定の特定（.github/workflows, .gitlab-ci.yml 等）

分析観点:
  1. レイヤー構成（例: Controller → Service → Repository）
  2. モジュール分割の方針（機能別 / レイヤー別 / ドメイン別）
  3. 依存関係の方向（import/require を追跡）
  4. 共有コード（utils, common, shared）の役割
  5. 外部連携（API呼び出し、DB接続、メッセージキュー）
  6. 状態管理パターン（グローバルstate, DI, Context 等）

抽出する規約:
  1. 命名規則
     - ファイル名: kebab-case / camelCase / snake_case
     - 変数・関数: camelCase / snake_case
     - クラス・型: PascalCase
     - 定数: UPPER_SNAKE_CASE
     - テストファイル: *.test.ts / *_test.go / test_*.py

  2. コード構成パターン
     - ファイルの内部構造（import順序、エクスポート方式）
     - エラーハンドリング方針（例外 / Result型 / エラーコード）
     - ログ出力パターン
     - コメント規約（JSDoc / docstring / 書かない方針）

  3. フレームワーク固有パターン
     - コンポーネント定義方式（関数 / クラス）
     - API定義方式（デコレータ / ルーター）
     - DB操作方式（ORM / クエリビルダー / 生SQL）

確認する内容:
  1. ビルド手順（npm run build, make, cargo build 等）
  2. テスト実行方法（ユニット / 統合 / E2E）
  3. リント・フォーマット実行方法
  4. 開発サーバー起動方法
  5. 環境変数の管理（.env.example の有無）
  6. Git運用（ブランチ戦略、コミットメッセージ規約）
  7. CI/CDパイプライン概要

---
name: {project-name}-guide
description: {プロジェクト名}の開発ガイド。アーキテクチャ、コーディング規約、開発ワークフローを提供する。{プロジェクト名}のコードを変更・追加する際に使用する。
---

# {Project Name} 開発ガイド

## 概要

- **言語**: {言語} {バージョン}
- **フレームワーク**: {フレームワーク} {バージョン}
- **パッケージマネージャ**: {PM}
- **テスト**: {テストFW}

## アーキテクチャ

### ディレクトリ構成

{3階層のツリー図。各主要ディレクトリに1行コメント}

### レイヤー構成

{アスキーアートの依存関係図}

{各レイヤーの責務を1-2行で}

## コーディング規約

### 命名規則

| 対象 | 規則 | 例 |
|---|---|---|
| ファイル名 | {規則} | {実例} |
| 関数・メソッド | {規則} | {実例} |
| クラス・型 | {規則} | {実例} |
| 定数 | {規則} | {実例} |
| テストファイル | {規則} | {実例} |

### コード構成

{ファイル内構造、import順序、エクスポート方式}

### エラーハンドリング

{プロジェクトで採用しているパターン。コード例付き}

### {フレームワーク固有パターン}

{該当する場合のみ。コード例付き}

## 開発ワークフロー

### よく使うコマンド

| 操作 | コマンド |
|---|---|
| ビルド | {コマンド} |
| テスト | {コマンド} |
| リント | {コマンド} |
| 開発サーバー | {コマンド} |

### 新規コード追加時のチェックリスト

1. {規約に沿ったファイル配置}
2. {テストファイルの作成}
3. {リント・フォーマットの実行}

{project}-guide/
├── SKILL.md（概要・ナビゲーション・頻出パターン）
└── references/
    ├── architecture.md（詳細なレイヤー・モジュール説明）
    ├── conventions.md（全規約の網羅的リスト）
    └── {domain}.md（ドメイン固有の知識）

ユーザー: 「このプロジェクトのアーキテクチャをスキルにして」

Copilot:
  1. スコープ確認（対象パス、スキル名、フォーカス）
  2. 構造スキャン → 技術スタック提示 → ユーザー確認
  3. アーキテクチャ分析 → レイヤー図提示 → ユーザー確認
  4. コーディング規約抽出 → 規約一覧提示 → ユーザー確認
  5. 開発ワークフロー把握 → コマンド一覧提示 → ユーザー確認
  6. 確認済み情報のみで SKILL.md 生成 → 出力先に保存
  7. 「生成しました。確認してください」

ユーザー: 「バックエンドAPIの規約だけスキルにして」

Copilot:
  1. フォーカスを「バックエンドAPI」に限定
  2. API関連ディレクトリのみ分析
  3. ルーティング、バリデーション、レスポンス形式の分析結果を提示 → ユーザー確認
  4. 確認済み情報のみで SKILL.md 生成

ユーザー: 「プロジェクト構成が変わったからスキルを更新して」

Copilot:
  1. 既存スキルを読み込み
  2. 差分分析（新ディレクトリ、削除ファイル、パターン変更）
  3. SKILL.md を更新
  4. 変更箇所をレポート