Adr

Step 4: ADR草案の生成

以下のテンプレート（docs/adr/template.md）に従い、収集した情報をもとにADRの草案を生成する。

ファイル名の決定:

• 形式: NNNN-kebab-case-title.md
• タイトル部分は日本語または英語のケバブケース
• 例: 0003-postgresql-の採用.md、0004-redis-cache-strategy.md

テンプレート構造:

# ADR-NNNN: タイトル

| 項目       | 内容       |
| ---------- | ---------- |
| ステータス | Proposed   |
| 日付       | YYYY-MM-DD |

---

## コンテキスト

（背景・問題・制約を記述）

## 決定

（何を決定したかを1〜3文で記述）

## 理由

（なぜこの選択をしたか。評価した観点ごとに説明）

## 代替案

| 代替案 | 不採用の理由 |
| ------ | ------------ |
| 〜     | 〜           |

## 影響

### ポジティブな影響

- 〜

### ネガティブな影響・トレードオフ

- 〜

## 関連ADR

- [ADR-XXXX](XXXX-title.md): 関連内容

記述ルール:

• すべて日本語で記述する
• ステータスは Proposed（草案）で開始する。ユーザーが Accepted を指定した場合はそちらを使用する
• 日付は今日の日付（YYYY-MM-DD形式）を使用する
• 「関連ADR」セクションは関連するものがなければ省略する
• コンテキスト・理由・影響は具体的に記述し、抽象的な記述を避ける

Step 5: 草案の提示と確認

生成した草案をユーザーに表示し、以下を確認する：

## ADR草案

ファイル名: docs/adr/NNNN-title.md

---
（ADRの内容全文）
---

保存してよいですか？修正が必要な箇所があれば教えてください。

ユーザーから修正の指示があれば内容を更新し、再度確認を取る。

Step 6: ファイルの保存

ユーザーの承認後、以下を実行する：

1. docs/adr/ ディレクトリが存在しない場合は作成する
2. 決定したファイル名でADRを保存する
3. docs/adr/README.md の一覧テーブルに新しいADRを追記する（README.md が存在する場合）
4. 保存完了をユーザーに通知する：

ADRを保存しました: docs/adr/NNNN-title.md

docs/adr/README.md の一覧も更新しました。
次のステップとして /commit でコミットすることをお勧めします。

注意事項

• 保存前に必ずユーザーの確認を取る
• ステータスは基本的に Proposed で作成し、レビュー後に Accepted へ変更する運用を推奨する
• 既存のADRを変更する場合は、元のADRのステータスを Superseded by ADR-NNNN に更新する
• ADRは一度 Accepted になったら内容を書き換えず、新しいADRで更新する（不変性の原則）
• docs/adr/README.md の一覧は常に最新の状態を保つ