はたらクラフト

SSoTとは?AIの回答がブレる原因と品質を安定させるシンプルな対策

業務改善ノウハウ

AIの回答が安定しないとき、プロンプトを見直しても満足する回答が得られないことはよくあります。

同じ依頼に違う回答が返ってきたり、対応漏れが起きたりする場合は、AIがどこを見るべきか・何が正しいかを判断できていないのかもしれません。

この記事では、情報を整理する考え方であるSSoTと、AIを使ったSSoT点検で回答の品質を高める具体的なやり方を解説します。

SSoTとは「どの情報を正とするか」を決める考え方

料金とデザインで正本を分け、各資料から参照するSSoTの図

SSoTとは、情報の種類ごとに「迷ったらここを見る」という場所を1つ決めて管理する考え方です。

「Single Source of Truth(シングル・ソース・オブ・トゥルース)」の略で、日本語では「信頼できる唯一の情報源」と呼ばれます。

大切なのは、すべての情報を1つの巨大なファイルへ詰め込むことではありません

料金は料金表、デザインはデザイン仕様書というように、情報の種類ごとに定義場所を分け、他の箇所からはその定義場所を参照するよう整理するのがSSoTです。

SSoTを守るとAIの回答が速く正確になる理由

デザインの正本を参照したAIが速く安定したページを作る流れ

たとえば、Webサイトの色や余白をページごとに1つ1つ指定していると、ページの作成者によって同じ役割のボタンや見出しでも見た目が少しずつ違ってしまったりします。

このようなWebサイトでAIに新規ページを作成させても、AIはどのページのデザインが正しいのかわからず、品質が安定しません。

SSoTが徹底されていれば、AIはデザインの正解がすぐにわかります。参考情報を探し回ったり、妥当なデザインを判断したりする必要がないので、回答のスピードは上がり、品質も安定します

身近な例で見るSSoTの崩れ方

4か所の料金情報を手作業で更新し、Webサイトに旧料金が残る例

SSoTが崩れた状態は、多くの会社で日常的に起きています。

たとえば、

  • 料金表のExcel
  • 会社案内のPDF
  • 営業資料
  • Webサイト

の4か所に同じ料金が書かれているとしましょう。この場合、値上げのたびに4か所すべてを直す手間がかかり、直し忘れで古い金額が残るリスクもあります。

はたらクラフトのWebサイトもSSoTを徹底しています。料金・サービス内容・デザインなどはそれぞれ1か所にまとめ、各ページや手順書はそこを参照するだけにしています。

SSoT違反をAIに点検させる依頼文(コピペ可)

AIに3つのSSoT違反を提案させ、確認後に1つずつ改善する流れ

CodexやClaude CodeのようなAIエージェントを使っているなら、SSoTの点検は簡単にできます。

対象はWebサイトに限りません。見積書のテンプレート、価格表、社内規定など、同じ情報が複数の場所に書かれていそうなフォルダを指定すれば、同じ考え方で点検できます。

対象のフォルダを指定したうえで、エージェントに次の指示をしてください。

フォルダ内を精査し、SSoTに違反している改善箇所を優先度の高い順に3つ提案して

最初は変更させず、改善候補だけを出してもらうのがポイントです。提案された場所と理由を確認し、納得できたものから「1番目の改善を実施して」のような形で依頼します。

すべてのSSoT違反を一度に直すと変更範囲が大きくなり、何が変わったのか確認する負担も増えます。1つずつ直して変更内容を確認し、問題がなければ次へ進むのが効率的です。

SSoTを整えてAIが迷わない状態へ

この記事の要点は次の3つです。

  • SSoTは同じ情報の定義場所が1つになるよう整理すること
  • SSoTを徹底すると、AIの回答が速くなり品質も安定する
  • SSoT整理は違反箇所を優先度が高い順に3つAIに提案させて確認し、順に直す

まずは次の休憩に入る前に、CodexやClaude CodeにSSoT点検を頼んでみてください。休憩後に提案内容を確認し、良いと思ったものを採用していきましょう。