どのエンジニアリングチームでも経験する瞬間があります。誰かが社内のWikiでドキュメントを見つけ、その指示に従ったところ、何かが壊れてしまったのです。彼らはチャンネルにメッセージを送ります：これはまだ正確ですか？これを書いた人は8ヶ月前に退職しました。ドキュメントによると、最終編集は2024年。
これが鮮度の問題です。さらに悪化しています。
古い契約は崩壊しつつあります
長い間、ドキュメントには暗黙の契約がありました：誰かがそれを書き、誰もがそれを信頼し、時々誰かがそれを更新する。そうかもしれません。その契約は、ドキュメントが判断力のある人たちによってのみ消費されていた時代には、かろうじて機能していました。セットアップ・ガイドが少しおかしいと思えば、シニア・エンジニアがその場で修正することもありました。
しかし、そのような世界は終わりました。今日、ドキュメントを読むのは人間だけではありません。AIツール、社内チャットボット、オンボーディング・オートメーション、そしてすべての言葉を同等の真実として扱う検索システムによって消費されるのです。AIアシスタントはドキュメントに目を細めて「うーん、これはちょっと古そうだな」とは考えません。
**古い文書とAIは、自信を持って間違った答えを出すのと同じです。
新鮮さが実際に意味するもの
鮮度とは、単に「これが最後に編集されたのはいつか」ということではありません。昨日編集されたドキュメントでも、まだ非推奨のAPIを参照しているかもしれません。真の新鮮さとは、複合的なシグナルです：
- レビュー状況。
- Link health. ドキュメント内のURLはまだ解決されていますか？
- 読者数.** これを実際に使っている人はいますか、それとも放棄されましたか？
- Contextual drift. この文書が同じままで、関連文書が変わりましたか？
- これが5つの言語で存在する場合、それらのすべてが最新ですか？
- Community signals. 読者がこれを古いとフラグを立てましたか？
これらはそれぞれ異なることを教えてくれます。これらを総合して、信頼スコアが算出されます。信頼スコアは、今現在、コンテンツにどれだけの信頼を置くべきかを表す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部構成の前編です。Part 2: Beyond Expiry Dates](/ja/blog/expiry-dates-are-just-not-enough/)では、継続的な鮮度モニタリングが、レビューの日付が空けたギャップをどのように埋めるかを探ります。