どのエンジニアリングチームも経験する瞬間がある。誰かが社内のWikiでドキュメントを見つけ、その指示に従ったところ、何かが壊れてしまった。彼らはチャンネルにメッセージを送る：誰も知らない。これを書いた人は8ヶ月前に退職した。ドキュメントによれば、最終編集は2024年だ。
これが鮮度の問題だ。さらに悪化している。
古い契約は崩壊しつつある
長い間、ドキュメントには暗黙の契約があった：誰かがそれを書き、誰もがそれを信頼し、時折誰かがそれを更新する。そうかもしれない。この契約は、ドキュメントが判断力のある人たちによってのみ消費されていた時代には、かろうじて機能していた。セットアップ・ガイドが少しおかしいと思えば、シニア・エンジニアがその場で対応した。
しかし、そのような世界は終わった。今日、ドキュメントを読むのは人間だけではない。AIツール、社内チャットボット、オンボーディング・オートメーション、そしてすべての単語を同等の真実として扱う検索システムによって消費されるのだ。AIアシスタントはドキュメントに目を細めて「うーん、これはちょっと古そうだな」とは思わない。
**古い文書とAIは、自信を持って間違った答えを出すことに等しい。
新鮮さが実際に意味するもの
鮮度とは、単に「これが最後に編集されたのはいつか」ということではない。昨日編集されたドキュメントでも、まだ非推奨のAPIに言及しているかもしれない。真の鮮度とは、複合的なシグナルである：
- レビュー状況** - これがまだ正確であることを誰かが明確に確認したか？
- リンクの健全性** - ドキュメント内のURLはまだ解決されているか？
- 読者数** - これを実際に使っている人はいるのか、それとも見捨てられたのか？
- この文書が同じままなのに、関連文書が変わっていないか。
- 翻訳の整合性** - これが5つの言語で存在する場合、それらすべてが最新ですか？
- コミュニティーのシグナル** - 読者がこれを古いとフラグを立てましたか？
これらはそれぞれ異なることを教えてくれる。これらを総合して、信頼スコアが算出される。信頼スコアは、今現在、コンテンツにどれだけの信頼を置くべきかを表す1つの数値である。
なぜ今これが重要なのか、具体的には
3つのことが重なり、鮮度が急務となっている：
1.AIが知識ベースを消費している
社内にRAGシステムを導入しているか、IDEでCopilotを使用しているか、ドキュメントからの質問にAIアシスタントが答えているかに関わらず、ソースの質がアウトプットの質を直接決定する。ゴミを入れ、ゴミを出すことは、かつてないほど文字通りのことだ。
開発者がAIアシスタントに "ステージングへのデプロイはどうすればいいですか？"と質問し、AIアシスタントが2年前のランブックを使って回答し、その後移行したインフラを参照した場合、その代償は間違った回答だけではありません。システム全体に対する信頼を失ったのだ。
2.チームはかつてないほど分散している
ベルリンのチーム、サンパウロのチーム、東京のチーム。全員が同じドキュメントを、多くの場合異なる言語で読んでいる。英語のソースが古くなると、その上に作られたすべての翻訳も古くなる。
3.コンプライアンスと監査への圧力が高まっている
規制業界は、"この文書が参照された時点で最新であったことを証明できるか？"と問い始めている。この文書が参照された時点で最新であったことを証明できますか？
新鮮さ第一のアプローチとはどのようなものか
核となる考え方はシンプルだ：**すべての文書は、信頼される権利を継続的に獲得しなければならない。
つまり
1.**すべての文書には、作成時に有効期限が設定される。例外はない。期限が来ると所有者に通知され、誰かが明示的に再承認するまで文書にフラグが立てられます。
2.**バックグラウンドで、システムはリンク切れ、読者動向、文脈の変化を継続的にチェックする。これらのシグナルは、誰も何もしなくても更新されるライブ・スコアに反映される。
3.**これは重要なメカニズムである。スコアの高い文書は検索結果の上位に浮上し、AIの回答ソースとして使用される資格を得る。スコアの低いドキュメントは順位が下がる。閾値を下回ると、AI回答から完全に除外される。
4.**透明性.**文書がなぜそのように採点されたのか、誰もが知ることができる。リンク切れ、レビュー期限切れ、読者数の少なさなど、誰も読まないバックエンドレポートに隠されたシグナルではなく、目に見えるシグナルです。
何もしないことの代償
鮮度を追跡しないとどうなるか：
- 新入社員は時代遅れのオンボーディング・ドキュメントに従い、最初の1週間を戸惑いながら過ごす。
- AIツールは間違った答えを出し、誰もその理由を理解できない。
- コンプライアンス文書が無言のうちに古くなり、監査リスクが生じる
- 翻訳が同期せず、異なる地域のチームが異なる現実のバージョンで作業する
- エンジニアがWikiを完全に信用しなくなり、Slackのメッセージに戻ってしまう。
古くなったドキュメントの複合コストは莫大だが、何かが壊れるまでは目に見えない。
実用的な出発点
一度にすべてを一新する必要はない。これらから始めましょう：
1.**最もよく読まれている文書トップ20を監査する。リンクはまだ有効か？内容は正確ですか？
2.**たとえ他に何もしなくても、すべての文書に「レビュー期限」を設定することで、説明責任が生まれます。
3.**社内にAIアシスタントがいる場合は、それがどのような文書から情報を引き出しているかを見てください。それらの文書は最新のものですか？
4.**文書のタイトルの横、検索結果、サイドバーなど、人々が目にする場所にスコアを置く。見えるようにすることで、維持するプレッシャーが生まれます。
ドキュメントの鮮度は機能ではない。組織の知識に対する考え方の根本的な転換なのだ。AIツールが大規模にドキュメントを消費し、再配布する世界では、問題は鮮度にこだわる余裕があるかどうかではない。そうしない余裕があるかどうかだ。
すべての文書は、それがまだ信頼に値するものであることを証明しなければならない。一度だけでなく、継続的に。
ラセピはそれを目指しています。鮮度が後付けではなく、他のすべての土台となるプラットフォームです。レビューの実施、ライブヘルススコアリング、鮮度に重点を置いた検索、信頼できるソースのみを使用するAI回答。
*これは2部構成のシリーズの第1部です。Part 2: Beyond Expiry Dates](/ja/blog/expiry-dates-are-just-not-enough/)では、継続的な鮮度モニタリングが、レビューの日付が空けたギャップをどのように埋めるかを探ります。