ドメインモデリング
設計の過程でプロジェクトのドメインモデルを能動的に構築・洗練します。これは能動的な手法です—用語に挑戦し、エッジケースとなるシナリオを考案し、用語集や決定事項が固まったその瞬間に書き留めます。(CONTEXT.md を語彙のためだけに読むことはこのスキルではありません—それはどのスキルでもできる単一行の習慣です。このスキルはモデルを変更するときのものであり、単に消費するだけではありません。)
ファイル構造
ほとんどのリポジトリは単一のコンテキストを持ちます:
/
├── CONTEXT.md
├── docs/
│ └── adr/
│ ├── 0001-event-sourced-orders.md
│ └── 0002-postgres-for-write-model.md
└── src/
ルートに CONTEXT-MAP.md が存在する場合、リポジトリは複数のコンテキストを持ちます。マップは各コンテキストがどこにあるかを示します:
/
├── CONTEXT-MAP.md
├── docs/
│ └── adr/ ← システム全体の決定
├── src/
│ ├── ordering/
│ │ ├── CONTEXT.md
│ │ └── docs/adr/ ← コンテキスト固有の決定
│ └── billing/
│ ├── CONTEXT.md
│ └── docs/adr/
ファイルはレイジーに作成します—書くべき内容がある場合のみです。CONTEXT.md が存在しない場合は、最初の用語が解決されたときに作成します。docs/adr/ が存在しない場合は、最初のADRが必要になったときに作成します。
セッション中に
用語集に対して挑戦する
ユーザーが CONTEXT.md の既存の言語と矛盾する用語を使用した場合、すぐに指摘します。「用語集では'キャンセル'をXと定義していますが、あなたはYを意味しているようです—どちらですか?」
あいまいな言語を洗練する
ユーザーが曖昧または過負荷な用語を使用した場合、正確な標準用語を提案します。「'アカウント'と言っていますが—顧客とユーザーのどちらを意味しますか?それらは別のものです。」
具体的なシナリオについて議論する
ドメインの関係について議論するとき、具体的なシナリオでストレステストを行います。エッジケースを探り、概念間の境界を正確に定義するようユーザーに促すシナリオを考案します。
コードと相互参照する
ユーザーが何かの動作を述べたとき、コードが一致するか確認します。矛盾を見つけた場合は表面化させます:「コードは注文全体をキャンセルしていますが、あなたは部分キャンセルが可能だと言いました—どちらが正しいですか?」
CONTEXT.md をインラインで更新する
用語が解決されたら、その場で CONTEXT.md を更新します。これらをまとめてバッチ処理しないでください—発生したらすぐにキャプチャします。CONTEXT-FORMAT.md の形式を使用してください。
CONTEXT.md は実装の詳細を完全に含まないようにしてください。CONTEXT.md を仕様書、スクラッチパッド、または実装上の決定のリポジトリとして扱わないでください。これは用語集であり、それ以外の何物でもありません。
ADRは控えめに提案する
以下がすべて真である場合にのみ、ADRの作成を提案します:
- 元に戻すのが難しい — 後で考えを変えるコストが大きい
- 文脈なしでは驚くべき — 将来の読者が「なぜこうしたのか?」と疑問に思う
- 実際のトレードオフの結果 — 真の代替案があり、特定の理由で1つを選んだ
3つのうち1つでも欠けている場合は、ADRをスキップします。ADR-FORMAT.md の形式を使用してください。