amose

Amọ̀ṣẹ́

計画、仕様、アーキテクチャ、実装、レビュー全体を通じて、プロジェクトのドメイン上の意味とユビキタス言語を管理します。境界づけられたコンテキストの区別を保ちます。共通の表現によって、異なるモデルが隠されないようにしてください。

重要なルールは、表現になじみがある場合でも適用できるか確認してください。現在確立されている意味を再利用します。古い記録を変更できない意図として扱ったり、矛盾を解消するためにビジネスルールを作り出したりしないでください。

モデルを明確にする

重要な意味を確定できる証拠のみを読みます。現在のドメイン言語の情報源、適用される決定やポリシー、関連するコード・テスト・設定・実行時の振る舞い、そして矛盾の解決に役立つ場合の関連履歴が対象です。実装と運用によって確認できるのは現在の振る舞いであり、それだけでドメイン上の意図が確定するわけではありません。

曖昧な用語、複数の意味で使われる用語、類義語、または相反する用語によって、スコープ、所有権、同一性、状態、ポリシー、振る舞いが変わり得る場合は、次の手順に従います。

1. 曖昧さまたは矛盾を明示します。
2. 競合する概念を区別できる、最小限の具体的なシナリオを使います。
3. 現在のドメイン言語および関連する証拠と照らし合わせます。
4. 証拠またはドメイン上の権限によって裏付けられる場合に限り、標準的な表現を提案します。

ユーザーが明確なドメイン上の意味を意図的に定めたり変更したりした場合は、モデルに一貫性を持たせるために必要な境界のみを確認します。インタビューを正当化するために、存在しない曖昧さを作り出さないでください。

有用なモデルの明確化によって、次の内容を確立または切り分けられます。

• 標準用語と避けるべき類義語。
• 概念上の同一性とライフサイクルの違い。
• 境界づけられたコンテキストと、コンテキストをまたぐ意味。
• 関係と所有権。
• 意味上の不変条件、または明示された意味と現在の振る舞いとの矛盾。

Yorùbá／英語の技術用語や用語集の管理には yoruba-glossary を使います。Amọ̀ṣẹ́ はプロジェクト固有のドメイン上の意味を担当します。

すでに理解されている、範囲の限られた重大な選択については、直接ひとつだけ尋ねます。目的、成功の定義、重大なトレードオフ、または潜在する依存関係のある選択が未確定の場合、あるいはインタビューを求められた場合は、arojinle を使います。未解決の構造や、重大な技術的適合性の問題には architect を使います。単に現在の実装に存在するという理由だけで、その実装の形をドメイン用語にしないでください。

標準的な言語を整合させる

すでにドメイン言語の情報源がある場合は、ドメイン言語を読み、解決されたモデルに変更があり、かつ書き込み権限がある場合は、その情報源を更新します。競合するプロジェクトメモリーの仕組みや、汎用的なドキュメント保管場所を作らないでください。

永続的なドメイン言語の保存先が定まっていない場合は、モデルの変更点を直接返し、その結果を現在の作業後も保持する必要がある場合に限り、永続化先がないことを明示します。CONTEXT.md、.learnings、.nongoals、ADR、.qp レコード、または別のリポジトリ慣習を作り出すのではなく、意図的な保存先をプロジェクトまたは依頼者に選んでもらいます。

このドメイン明確化の境界は、許可された ADR 作成の依頼で、プロジェクトの慣習がない場合に ADR の代替手段を使うことを妨げません。ドメインの明確化だけでは、ADR の作成は許可されません。

ドメインモデルの変更を受けて、別のワークフローで仕様、アーキテクチャ、ドキュメント、テスト、またはポリシーを更新することがあります。それらの成果物は、それぞれ本来のワークフローが担当します。Amọ̀ṣẹ́ はプロジェクトの標準的なドメイン記録を管理し、明確になった意味を他の担当者に提供します。

永続的なドメイン記録を管理する

依頼がプロジェクトの既存のドメイン記録の内容またはライフサイクルに関わる場合は、その記録を管理します。

• .learnings → 学びを読みます。
• .nongoals → 対象外を読みます。
• ADR の該当性判定またはライフサイクル → ADRを読みます。

記録には、プロジェクト内ですでに使われている保存先を使用します。その形式と権限の境界を維持します。記録の変更は、確立されたドメイン上の意味、または許可されたプロジェクトの決定を反映する必要があります。タスクのメモ、一時的な保留、実装履歴を、永続的なドメイン記録にしないでください。

返却

解決した用語、アイデンティティ、関係性、所有権、不変条件、必要に応じて識別に役立つ例、および残っている意味上の矛盾や重大な判断事項と、その根拠を返します。

新たに明らかになった要望、事実、または技術上の不足についても、根拠となる情報を添えて同じ呼び出し元に返します。呼び出し元が結果を統合し、影響を受ける作業のみを再開します。ドメインに関する確認によって、別の取り組みを開始することはありません。

正規のドメイン用語または永続的なドメイン記録を更新した場合は、更新先と検証結果を報告します。