第35章：【ワーク】作りたい機能の「単語帳」をAIと一緒に作り、不整合を直す 📚🤖✨

単語帳ワーク

この章は“コードを書く前の準備運動”です💪 DDDでめちゃ大事な ユビキタス言語（共通言語） を、AIと一緒に「単語帳」にして、言葉のズレ（＝バグ予備軍） を先に潰します🧯🔥

今日のゴール 🎯

アプリ全体じゃなくてOK！機能1つでいきます😊

例：

ここでは例として、**「イベント予約をキャンセルする」**で進めます🎫❌

難しく考えず、箇条書きでOKです😄

例：

ここで大事なのは、言葉が自然なことです🌱 コードっぽい単語（DTOとかRepositoryとか）は今は不要🙅‍♀️

Copilot Chat（またはAI拡張）のチャットで、次を投げます👇

あなたはドメインエキスパート兼DDDコーチです。
以下の機能説明から「ドメイン用語」を全て抜き出し、候補の単語リストを作ってください。
技術用語（DTO、DB、APIなど）は除外し、業務の言葉だけにしてください。

--- 機能説明 ---
（ここにあなたの箇条書きを貼る）
--- ここまで ---

✅ 返ってきた「単語リスト」を docs/glossary.md の下書きに貼ります📎

次がこの章の本題です！ 同じ単語が場面によって意味が変わると、設計がグラつきます😵‍💫

次の用語リストについて、
1) 意味が曖昧になりやすい単語
2) 人によって解釈が割れそうな単語
3) 似た単語（同義語・近い概念）が混ざっていそうな単語
を指摘して、理由も添えてください。

用語リスト:
（AIが出した単語リストを貼る）

よく燃える単語たち（例）🔥

docs/glossary.md に、最低限これを書きます👇 表にすると見やすいです😊

用語	定義（1〜2文）	例文（自然な日本語）	似てる言葉/禁止ワード	メモ
予約	イベント参加枠を確保した状態。支払い完了で「確定予約」になる。	「予約を確定する」	申込（混同注意）	状態がある
申込	参加希望を出した状態。支払い前でも成立する。	「申込を取り消す」	予約（禁止）	支払い前
キャンセル	確定した予約を無効にする行為。必要なら返金処理を伴う。	「予約をキャンセルする」	取消（できれば統一）	返金条件あり
返金	支払い済み金額を返す処理。手数料が引かれる場合がある。	「返金額を計算する」	払い戻し（統一）	ルール重要

この時点で「予約」と「申込」を分けたので、設計も勝手にスッキリします🥳✨

単語帳ができたら、AIに意地悪レビューをさせます😈

あなたは仕様の矛盾を見つけるプロのレビュアーです。
以下の単語帳の定義に矛盾や穴がないかチェックしてください。

観点:
- 用語の重複/同義語が混ざってないか
- 状態の前後関係が破綻してないか（例：申込→予約→確定 など）
- 「このケースではどの単語を使う？」が迷う箇所がないか
- UI文言にした時に混乱しそうな部分

--- 単語帳 ---
（glossary.md を貼る）
--- ここまで ---

🔧 指摘が出たら、単語帳を直します。ここ、地味だけど最強に効くところです💊✨

最後に、AIに「命名ルール案」を出させます。これで AIにコード生成させる時もブレにくいです👍

次の単語帳をもとに、C#の命名案を提案してください。
- Entity / ValueObject / Enum / メソッド名の候補
- 「申込」と「予約」を混同しないための命名ルール
- 禁止したい命名（例: Order を乱用しないなど）

--- 単語帳 ---
（glossary.md を貼る）
--- ここまで ---

たとえばこんなふうに固まります👇（例）

今後その機能をAIに作らせる時、毎回これを最初に貼ると強いです💪

この機能では用語を次のように定義する：
- 申込: （定義）
- 予約: （定義）
- 確定予約: （定義）
- キャンセル: （定義）
禁止: 申込の状態を予約と呼ばない。返金とキャンセルを同義にしない。
この用語に従って、命名・コメント・UI文言を統一すること。

次の3つを作ってください👇