テクニカルスパイクドキュメントの作成

開発を進める前に答えるべき重要な技術的問題を研究するための、時間制限付きテクニカルスパイクドキュメントを作成します。各スパイクは、明確な成果物とスケジュール表を含む特定の技術的決定に焦点を当てています。

ドキュメント構成

${input:FolderPath|docs/spikes} ディレクトリに個別ファイルを作成します。各ファイルは以下のパターンで命名します: [category]-[short-description]-spike.md（例: api-copilot-integration-spike.md、performance-realtime-audio-spike.md）。

---
title: "${input:SpikeTitle}"
category: "${input:Category|Technical}"
status: "🔴 Not Started"
priority: "${input:Priority|High}"
timebox: "${input:Timebox|1 week}"
created: [YYYY-MM-DD]
updated: [YYYY-MM-DD]
owner: "${input:Owner}"
tags: ["technical-spike", "${input:Category|technical}", "research"]
---

# ${input:SpikeTitle}

## Summary

**Spike Objective:** [解決が必要な明確で具体的な質問または決定]

**Why This Matters:** [開発・アーキテクチャ決定への影響]

**Timebox:** [このスパイクに割当てた時間]

**Decision Deadline:** [開発がブロックされるのを避けるために解決すべき期限]

## Research Question(s)

**Primary Question:** [回答すべき主要な技術的問題]

**Secondary Questions:**

- [関連する質問 1]
- [関連する質問 2]
- [関連する質問 3]

## Investigation Plan

### Research Tasks

- [ ] [具体的なリサーチタスク 1]
- [ ] [具体的なリサーチタスク 2]
- [ ] [具体的なリサーチタスク 3]
- [ ] [概念実証・プロトタイプの作成]
- [ ] [調査結果と推奨事項の文書化]

### Success Criteria

**このスパイクは以下の場合に完了します:**

- [ ] [具体的な基準 1]
- [ ] [具体的な基準 2]
- [ ] [明確な推奨事項が文書化されている]
- [ ] [概念実証が完了している（必要な場合）]

## Technical Context

**Related Components:** [この決定の影響を受けるシステムコンポーネント一覧]

**Dependencies:** [この問題の解決に依存する他のスパイクや決定]

**Constraints:** [ソリューションに影響する既知の制限事項または要件]

## Research Findings

### Investigation Results

[収集したリサーチ結果、テスト結果、証拠を文書化]

### Prototype/Testing Notes

[プロトタイプ、スパイク、技術実験の結果]

### External Resources

- [関連ドキュメントへのリンク]
- [API リファレンスへのリンク]
- [コミュニティディスカッションへのリンク]
- [例やチュートリアルへのリンク]

## Decision

### Recommendation

[リサーチ結果に基づいた明確な推奨事項]

### Rationale

[この手法が他の選択肢より選ばれた理由]

### Implementation Notes

[実装に関する重要な検討事項]

### Follow-up Actions

- [ ] [アクション項目 1]
- [ ] [アクション項目 2]
- [ ] [アーキテクチャドキュメントを更新]
- [ ] [実装タスクを作成]

## Status History

| Date   | Status         | Notes                      |
| ------ | -------------- | -------------------------- |
| [Date] | 🔴 Not Started | Spike created and scoped   |
| [Date] | 🟡 In Progress | Research commenced         |
| [Date] | 🟢 Complete    | [Resolution summary]       |

---

_Last updated: [Date] by [Name]_

テクニカルスパイクのカテゴリ

API インテグレーション

• サードパーティ API の機能と制限事項
• インテグレーションパターンと認証
• レート制限とパフォーマンス特性

アーキテクチャ & デザイン

• システムアーキテクチャの決定
• デザインパターンの適用可能性
• コンポーネント相互作用モデル

パフォーマンス & スケーラビリティ

• パフォーマンス要件と制約
• スケーラビリティのボトルネックとソリューション
• リソース利用パターン

プラットフォーム & インフラストラクチャ

• プラットフォームの機能と制限事項
• インフラストラクチャ要件
• デプロイメントとホスティングの検討事項

セキュリティ & コンプライアンス

• セキュリティ要件と実装
• コンプライアンス制約
• 認証と認可のアプローチ

ユーザーエクスペリエンス

• ユーザーインタラクションパターン
• アクセシビリティ要件
• インターフェース設計の決定

ファイル命名規則

カテゴリと特定の未解決事項を示すわかりやすい kebab-case の名前を使用してください:

API/インテグレーション例:

• api-copilot-chat-integration-spike.md
• api-azure-speech-realtime-spike.md
• api-vscode-extension-capabilities-spike.md

パフォーマンス例:

• performance-audio-processing-latency-spike.md
• performance-extension-host-limitations-spike.md
• performance-webrtc-reliability-spike.md

アーキテクチャ例:

• architecture-voice-pipeline-design-spike.md
• architecture-state-management-spike.md
• architecture-error-handling-strategy-spike.md

AI エージェント向けベストプラクティス

1. 1つの質問につき1つのスパイク: 各ドキュメントは単一の技術的決定またはリサーチ質問に焦点を当てる

2. 時間制限付きリサーチ: 各スパイクの具体的な時間制限と成果物を定義する

3. 証拠に基づいた決定: 完了とマークする前に具体的な証拠（テスト、プロトタイプ、ドキュメント）を要求する

4. 明確な推奨事項: 具体的な推奨事項と実装の根拠を文書化する

5. 依存関係の追跡: スパイク間の関係およびプロジェクト決定への影響を特定する

6. 成果物重視: すべてのスパイクは実行可能な決定または推奨事項をもたらす必要があります

リサーチ戦略

フェーズ 1: 情報収集

1. 既存ドキュメントを検索 - search/fetch ツールを使用
2. コードベースを分析 - 既存パターンと制約を理解
3. 外部リソースを調査 - API、ライブラリ、例を研究

フェーズ 2: 検証 & テスト

1. 特定の仮説をテストするフォーカスされたプロトタイプを作成
2. 仮定を検証するための対象を絞ったテストを実施
3. 支持する証拠を含むテスト結果を文書化

フェーズ 3: 決定 & 文書化

1. 調査結果を明確な推奨事項に統合
2. 開発チーム向けに実装ガイダンスを文書化
3. 実装のためのフォローアップタスクを作成

ツール使用方法

• search/searchResults: 既存のソリューションとドキュメントを調査
• fetch/githubRepo: 外部 API、ライブラリ、例を分析
• codebase: 既存のシステム制約とパターンを理解
• runTasks: プロトタイプと検証テストを実行
• editFiles: リサーチの進捗と調査結果を更新
• vscodeAPI: VS Code 拡張機能の機能と制限事項をテスト

重要な技術的決定を解決し、開発の進行をブロック解除する時間制限付きリサーチに焦点を当ててください。