# 調査 & 設計決定テンプレート

---
**目的**: 技術設計に情報を提供する発見結果、アーキテクチャ調査、および根拠を記録する。

**使い方**:
- 発見フェーズ中に調査活動と結果を記録。
- `design.md`には詳細すぎる設計決定のトレードオフを文書化。
- 将来の監査や再利用のための参照と証拠を提供。
---

## 概要
- **機能**: `<feature-name>`
- **発見スコープ**: 新機能 / 拡張 / 単純な追加 / 複雑な連携
- **主な発見事項**:
  - 発見1
  - 発見2
  - 発見3

## 調査ログ
注目すべき調査ステップとその結果を文書化。読みやすさのためにトピックごとにグループ化。

### [トピックまたは質問]
- **コンテキスト**: この調査のきっかけは何か？
- **参照したソース**: リンク、ドキュメント、APIリファレンス、ベンチマーク
- **発見事項**: 洞察を要約した簡潔な箇条書き
- **影響**: これがアーキテクチャ、契約、または実装にどう影響するか

_各主要トピックについてサブセクションを繰り返す。_

## アーキテクチャパターン評価
検討した候補パターンまたはアプローチをリスト。必要に応じてテーブル形式を使用。

| オプション | 説明 | 強み | リスク / 制限 | 備考 |
|----------|------|------|--------------|------|
| ヘキサゴナル | コアドメイン周りのポート & アダプター抽象化 | 明確な境界、テスト可能なコア | アダプターレイヤーの構築が必要 | 既存のステアリング原則Xに合致 |

## 設計決定
`design.md`に影響を与える主要な決定を記録。重要なトレードオフのある選択に焦点を当てる。

### 決定: `<タイトル>`
- **コンテキスト**: 決定を促した問題または要件
- **検討した代替案**:
  1. オプションA — 短い説明
  2. オプションB — 短い説明
- **選択したアプローチ**: 何を選択し、どう機能するか
- **根拠**: このアプローチが現在のプロジェクトコンテキストに適する理由
- **トレードオフ**: メリット vs 妥協点
- **フォローアップ**: 実装またはテスト中に確認すべき事項

_各決定についてサブセクションを繰り返す。_

## リスク & 軽減策
- リスク1 — 提案する軽減策
- リスク2 — 提案する軽減策
- リスク3 — 提案する軽減策

## 参考文献
正規のリンクと引用を提供（公式ドキュメント、標準、ADR、内部ガイドライン）。
- [タイトル](https://example.com) — 関連性の簡単なメモ
- ...

---

## 変更履歴

| 日付 | バージョン | 変更者 | 変更内容 |
| ---- | ---------- | ------ | -------- |
| {{DATE}} | v1.0 | {{AUTHOR}} | 初版作成 |