ssotchk

単一の真実が存在する場所をすべて見つけ、その正当な所在を特定し、何も変更せずに不整合を報告します。

目標

単一の信頼できる情報源（SSOT）に関する違反を特定します。つまり、1つの事実が複数の成果物やプラットフォームに重複、言い換え、または矛盾する形で存在する状態です。コピーが N 個ある事実には N-1 個のリスクが伴います。コピー同士の同期が崩れるためです。出力は、その事実がどこに存在するか、どのコピーを正本とするか、残りのコピーをどう扱うかを示すマップです。これに基づき、ssotize または人間が対応できます。これは読み取り専用です。

多くの成果物にわたって整理を行うとき、特に状態が乱雑な場合やレガシーな状態にある場合に利用してください。事実を一度きちんと SSOT 化した後に必要なのは、統合ではなく維持管理です。

ワークフロー

1. 対象とする真実を特定します。追跡するのは文書全体ではなく、具体的な事実、値、仕様、決定、ステータス、または定義です。
2. 対象となる成果物やプラットフォームにあるすべての出現箇所を列挙します。
3. 各出現箇所を分類します。完全一致、言い換え、一部のみ、古い情報、または矛盾です。
4. 正本となる所在を選びます。最も権威があり、最もよく保守され、事実が実際に変更される場所に最も近い場所です（値ならコード／設定、決定なら仕様書、ステータスならチケット）。恣意的に選んではいけません。
5. 正本以外の各出現箇所に対する対応を決めます。重複解消（冗長なコピー）、参照（ドキュメントは正本にリンクし、コードは正本をインポート／ソース指定／インクルードし、設定は共有の読み取りを利用する）、または調整（内容が一致しないため、どちらが正しいか人間の判断が必要）です。
6. 報告します。出現箇所の表（場所・種類・対応）、正本として提案する所在と、その理由を示す1行の説明、さらに判断が必要な矛盾／不整合の一覧を別に記載します。

ルール

• 読み取り専用です。提案はしても、編集、移動、削除はしないでください。
• 調査結果が空でも有効です。報告を埋めるために不整合を捏造してはいけません。
• 矛盾は単なる重複と分けて扱います。矛盾する値のどちらが「正しい」かを暗黙に決めてはいけません。
• 詳細が正本以外のコピーにのみ存在する場合は、その旨を明示してください。そのコピーを削除する前に、詳細を正本に取り込む必要があります。
• 境界を尊重してください。コピーが異なる信頼／権限の範囲（非公開と公開、社内向けと顧客向けなど）にまたがる場合は、無視せず明示してください。
• プラットフォームの特性を考慮してください。内容をトランスクルードできる場所もあれば、リンクしかできない場所や、引用とリンクの両方が必要な場所もあります。

検証

完了する前に、次の点を確認してください。

1. 2つ目の方法で再度列挙します。異なる検索語、類義語、またはツールを使い、報告で見落とした出現箇所が見つからないことを確認してください。網羅性は SSOT における最大のリスクです。見つけられなかったコピーは、いずれ同期が崩れます。
2. 正本となる所在を、決めつけずに根拠を示して正当化してください。
3. 報告を実行可能なものにしてください。人間または ssotize が、何も再調査せずに対応できるようにします。