GitHub Copilot applyToパターンで実現する条件分岐型インストラクション管理¶

{
  "chat.instructionsFilesLocations": {
    ".github/instructions/**/*.instructions.md": true
  }
}

{
  "chat.instructionsFilesLocations": {
    ".github/instructions/**/*.instructions.md": true,
    "docs/instructions/**/*.instructions.md": true
  }
}

project-root/
├── .github/
│   ├── copilot-instructions.md         # 基本ルール（確実読み込み）
│   └── instructions/
│       ├── frontend.instructions.md    # React/TypeScript用
│       ├── backend.instructions.md     # Python/API用
│       ├── meeting.instructions.md     # 議事録用
│       └── docs.instructions.md        # ドキュメント用
├── .vscode/
│   └── settings.json                   # プロジェクト設定
└── docs/
    └── instructions/
        └── style.instructions.md       # スタイルガイド用

---
description: "React/TypeScript専用のコーディング規則"
applyTo: "**/*.tsx,**/*.ts"
---

# React/TypeScript開発ガイドライン

## 基本ルール
- React Hooksの依存配列を必ず適切に設定
- TypeScriptは strict モードで使用
- コンポーネント名はPascalCase
- カスタムHooksは "use" プレフィックス必須

## インポート順序
1. React関連
2. 外部ライブラリ
3. 内部コンポーネント
4. 型定義
5. スタイル

## 命名規則
- コンポーネントファイル: `ComponentName.tsx`
- カスタムHooks: `useFeatureName.ts`
- 型定義: `types/FeatureName.ts`

---
description: "Python/FastAPI専用のコーディング規則"
applyTo: "**/*.py"
---

# Python/FastAPI開発ガイドライン

## 基本ルール
- Type hints必須
- Black フォーマッター使用
- docstringはGoogle形式
- 例外処理は必ず実装

## ファイル構成
- APIエンドポイント: `routers/feature_name.py`
- データモデル: `models/feature_name.py`
- ビジネスロジック: `services/feature_name.py`
- ユーティリティ: `utils/feature_name.py`

## 命名規則
- 関数名: snake_case
- クラス名: PascalCase
- 定数: UPPER_SNAKE_CASE
- プライベート関数: _private_function

---
description: "会議議事録作成時の自動フォーマット"
applyTo: "meeting-*.md,**/meetings/*.md"
---

# 会議議事録作成ガイドライン

## ファイル命名規則
- 形式: `meeting-YYYY-MM-DD-[会議名].md`
- 例: `meeting-2024-01-15-sprint-planning.md`

## 必須構成
1. **会議情報**
   - 日時：
   - 参加者：
   - 会議種別：

2. **議題**
   - 各議題に番号を付与
   - 議論内容を簡潔に記録

3. **決定事項**
   - 何が決定されたか明確に記載
   - 影響範囲を含める

4. **アクションアイテム**
   - [ ] タスク内容（担当者：@username、期限：YYYY-MM-DD）

## 注意点
- 参加者にはGitHubユーザー名を使用
- 期限は必ず設定
- 未解決事項は次回議題に追加

---
description: "PR作成時の自動テンプレート適用"
applyTo: "pr-*.md,pull_request_template.md"
---

# プルリクエスト作成ガイドライン

## ファイル命名規則
- 形式: `pr-[機能名]-YYYY-MM-DD.md`
- 例: `pr-user-authentication-2024-01-15.md`

## 必須項目
### 📋 変更内容
- [ ] 新機能追加
- [ ] バグ修正
- [ ] リファクタリング
- [ ] ドキュメント更新

### 🔍 テスト
- [ ] 単体テスト追加/更新
- [ ] 結合テスト実施
- [ ] 手動テスト実施
- [ ] エラーケースのテスト

### 📝 チェックリスト
- [ ] コードレビュー依頼
- [ ] CI/CDパイプライン通過
- [ ] ドキュメント更新
- [ ] 既存機能への影響確認

## ブランチ命名規則
- feature/機能名
- bugfix/バグ修正内容
- hotfix/緊急修正内容

---
description: "技術仕様書作成時の構成とフォーマット"
applyTo: "**/*-spec.md,**/specs/*.md"
---

# 技術仕様書作成ガイドライン

## ファイル命名規則
- 形式: `[機能名]-spec.md`
- 例: `user-authentication-spec.md`

## 必須構成
1. **概要**
   - 機能の目的と背景
   - 想定ユーザー
   - 成功基準

2. **技術仕様**
   - アーキテクチャ図
   - データベース設計
   - API仕様

3. **実装方針**
   - 使用技術
   - 設計パターン
   - セキュリティ考慮事項

4. **テスト仕様**
   - 単体テスト範囲
   - 結合テスト範囲
   - 性能要件

## 図表の扱い
- Mermaidを使用してフロー図を作成
- PlantUMLでシーケンス図を作成
- 画像は `assets/images/` に配置

# .github/copilot-instructions.md（基本ルール - 確実読み込み）

## 全体共通ルール
- エラーハンドリング必須
- ログ出力の統一
- セキュリティ原則の遵守

## ファイル作成時の命名規則
- 議事録: `meeting-YYYY-MM-DD-[会議名].md`
- PR: `pr-[機能名]-YYYY-MM-DD.md`
- 仕様書: `[機能名]-spec.md`
- テスト: `[対象].test.[拡張子]`

## 技術スタック別の詳細ルール
フロントエンド: [.github/instructions/frontend.instructions.md]
バックエンド: [.github/instructions/backend.instructions.md]
インフラ: [.github/instructions/infrastructure.instructions.md]

従来の方式：
- 全インストラクション読み込み: 15,000トークン
- 実際に関連する情報: 3,000トークン
- 効率: 20%

applyTo方式：
- 該当インストラクションのみ読み込み: 4,000トークン
- 実際に関連する情報: 3,500トークン
- 効率: 87.5%

// ❌ 拡張子なし
"chat.instructionsFilesLocations": {
    ".github/instructions/**/*.md": true
}

// ✅ 正しい拡張子
"chat.instructionsFilesLocations": {
    ".github/instructions/**/*.instructions.md": true
}

# ❌ 間違った記述
applyTo: "*.tsx"

# ✅ 正しい記述
applyTo: "**/*.tsx"

❌ 避けるべき構成:
├── instructions/
│   ├── react-hooks.instructions.md
│   ├── react-context.instructions.md
│   ├── react-components.instructions.md
│   └── react-routing.instructions.md

✅ 推奨構成:
├── instructions/
│   ├── frontend.instructions.md
│   ├── backend.instructions.md
│   └── docs.instructions.md