# Stripeはなぜ社内ドキュメント50万件を5,000件に絞ったのか

- 番組: [Agentic Conversations (formally mlops.community)](https://ai-curator.jp/podcasts/shows/cmv3z5c0n000l5o10j1ogyu9h)（Demetrios）
- 元のタイトル: Why Stripe Cut 500,000 Internal Docs Down to 5,000?
- 配信日: 2026年11月13日
- 長さ: 32分
- 要約作成日: 2026年11月13日
- トピック: [#AIエージェント](https://ai-curator.jp/topics/AI%E3%82%A8%E3%83%BC%E3%82%B8%E3%82%A7%E3%83%B3%E3%83%88) [#ドキュメント](https://ai-curator.jp/topics/%E3%83%89%E3%82%AD%E3%83%A5%E3%83%A1%E3%83%B3%E3%83%88) [#社内ナレッジ管理](https://ai-curator.jp/topics/%E7%A4%BE%E5%86%85%E3%83%8A%E3%83%AC%E3%83%83%E3%82%B8%E7%AE%A1%E7%90%86) [#意思決定記録](https://ai-curator.jp/topics/%E6%84%8F%E6%80%9D%E6%B1%BA%E5%AE%9A%E8%A8%98%E9%8C%B2) [#コンテキスト管理](https://ai-curator.jp/topics/%E3%82%B3%E3%83%B3%E3%83%86%E3%82%AD%E3%82%B9%E3%83%88%E7%AE%A1%E7%90%86) [#LLM](https://ai-curator.jp/topics/LLM)
- URL: https://ai-curator.jp/podcasts/cmweacpff00005g123jxfhibd

## 要約

Falconer創業者でDocumentation for Developersの共著者Dave Nunezが、Waymo車内でDemetriosと、AIエージェント時代のドキュメントについて語った回。人間とエージェントでは必要な形式が異なること、エージェントが最新ドキュメントを読まず学習データに頼る問題、意思決定記録の価値を論じる。StripeでドキュメントをDave曰く50万件から5,000件に絞った経験や、誤情報によるインシデントの責任の所在、AI生成の水増し文書への批判も語られた。

## ポイント

- エージェントには大量のMarkdownを渡し、人間には図や視覚的な形式で全体像を示すべきで、両者を同じ扱いにするのは誤りだとDaveは主張している。
- エージェントは速度のため学習データに頼り、最新ページを取得しないことがあり、Vercelの例ではDocker対応の発表後も競合を推奨し続けたという。
- 意思決定記録（誰が・なぜ決めたか）をタイムスタンプ付きで残すことは、人間にもエージェントにも価値が高い。
- 社内文書の有用なものは1〜2%程度で、大半は重複や古い文書だとDaveは述べる。Stripeでは50万件を5,000件に絞り、残りはエージェントによる同期が現実的になるという。
- エージェントが古い文書に基づき誤判断するとインシデントになり得る。文書にオーナーを置き、人事評価にも反映するなど説明責任から始めるべきだと述べている。
- AIで量産された冗長な文書は読者の時間を奪い、いずれ書き手の評判を損なうため、人間による推敲が必要だという見方を示した。

## 章立て

- [00:00] **導入：社内ドキュメントへの関心** — WaymoでDaveと対談開始。外部より社内ドキュメントに興奮していたことが、エージェント時代に生きたと語る。
- [03:02] **人間とエージェントが必要とするもの** — エージェントは大量のMarkdownを読めるが、人間は視覚的で簡潔な形式を求める。人間向け体験の重要性が増している。
- [06:11] **エージェントが最新ドキュメントを読まない問題** — ツールごとの使いこなし評価の話から、エージェントが学習データに頼り最新ページを取得しない問題を議論する。
- [09:42] **意思決定記録と文脈の保存** — 決定の理由と経緯を残す意思決定ドキュメントの価値を、具体例とともに語る。
- [13:26] **古いドキュメントの整理とStripeの事例** — 有用な文書は1〜2%程度で、検索を汚す古い文書を削除する重要性と、50万件から5,000件への絞り込みを説明する。
- [17:01] **図の活用と矛盾する文書によるインシデント** — 長文より図やチェックリストが有効であること、コードと文書の矛盾が重大インシデントにつながり得ることを語る。
- [20:42] **責任の所在とドキュメントの位置づけ** — エージェントの失敗の責任は人にあり、文書にオーナーを置くこと、ドキュメントを製品の一部として扱うことを提案する。
- [26:27] **AI生成の水増しと読者への敬意** — AIが量産する冗長な文書への批判と、人間の推敲の必要性を語り、雑談で締める。

## 解説記事

Falconer創業者でDocumentation for Developersの共著者でもあるDave Nunezが、Demetriosとサンフランシスコ市内のWaymo車内で対談した。テーマはAIエージェント時代のドキュメント。Daveは以前から外部向けより社内ドキュメントに関心があったといい、それがエージェントを支える基盤になったと語る。

#### 人間とエージェントは別の読者

Daveは、ドキュメントは人間とエージェントで求められるものが根本的に違うと主張する。エージェントはMarkdownを一文字残らず読めるので、文脈を網羅した大量のテキストを渡せばよい。一方、人間は全文を読みたくないし、エージェントが代わりに出せない情報、たとえば視覚的な全体像を求めて訪れる。

また、エージェントには「明日までに課金機能を実装しなければ」という焦りや、ドキュメントが読みにくいときの徒労感がない。だからこそ人間向けの体験が良ければ、開発者に好印象を与えるマーケティングサイトのような役割も果たす。現状は「悪いドキュメントをエージェントに書かせている」だけで、誰の助けにもなっていないというのが彼の見立てだ。

#### エージェントは最新ドキュメントを読まない

Demetriosは、エージェントがどのツールをうまく使えるかを評価する取り組みに触れ、なぜ使いやすいツールとそうでないツールがあるのか不明だと指摘した。Daveは、StripeのMichelle Booがエージェントがドキュメント内の指示を無視する問題について語っていたと紹介する。

理由として彼が挙げるのは速度だ。エージェントは光速より速く動けないので、「すでに知っている」前提で学習データに頼り、最新ページを取りに行かない。Vercelの例では、Docker関連の大型発表後もエージェントが競合を勧め続けたという。各社が10倍の量を書く状況では、問い合わせのたびに10万件のドキュメントを読ませることは非現実的で、問題は今後さらに大きくなると述べている。

#### 意思決定記録と文書の断捨離

Demetriosは、なぜその決定をしたか、誰が、どんな根拠でというDecision docの価値を挙げる。Daveも同意し、人間は自分の過去の発言すら忘れるので、決定を記録しておけばエージェントも人間も同じ議論を繰り返さずに済むと言う。たとえばMongoをMySQLに書き換えようとする新任エンジニアに、過去の議論を示せる。Daveの助言は、完璧にしようとせず、タイムスタンプ付きで時系列に書き残すことだ。

さらにDaveは、UberやStripe、顧問先での経験から、社内文書で有用なのは1〜2%程度で、大半は重複や非推奨機能の古い文書だと述べる。検索で古い文書が上位に出る例も挙げた。Stripeでは50万件を、実際に価値のある5,000件にまで絞った。この規模なら、エージェントにコードベースやタスクと同期させ続けることが現実的になり、9割程度は保てるという。長大な手順書より、主要な段階を示す図やチェックリストのほうが役立つとも語った。

#### 誰が責任を負うのか

文書とコードとチケットが食い違うと、エージェントは「コイントスのように」判断してしまう。Daveは、エージェントが文書を根拠に誤判断し、復旧に数週間かかった事例を知人から聞いたと言う。Uberでは人間が文書を更新せず似た問題が起きたが、エージェントが書いた文書は人が信用しやすく、より危険になりうるという見方だ。

ここ数年は「Claudeのせい」と言えたが、今後は人事評価でも信頼性の責任を問われるようになり、変わっていくとDaveは楽観的に語る。助言は、ツールやスタイルガイドより先にオーナーを決めること。担当者名を付け、職務評価に組み込めば、人は自然と気を配るようになる。BezosのAPIをめぐるメモにも触れ、ドキュメント化されたインターフェースがあれば会議は減ると述べた。エージェントのために、稼働時間やコミュニケーション方法も書いておくとよいとする。

#### 水増し文書は読者への無礼

終盤で二人は、AIが量産する冗長な文書を批判する。Daveは、読むのに書くより時間がかかる文書は読まないと言い、そうした文書を「brovella」と呼ぶ。人の時間を奪う行為だという。Demetriosは、読者が目的の情報にたどり着けるよう「探しているのはこれですか」と導く工夫が、ドキュメントを資産にすると述べた。

#### まとめ

本対談の核心は、ドキュメントを量ではなく鮮度、所有者、読者別の形式で設計し直す必要がある、という点にある。日本企業でも社内Wikiやナレッジを生成AIに接続する動きは増えており、古い文書の削除、オーナーの明確化、意思決定の記録は、RAGやエージェント導入の前提として参考になる。なお数字や事例は登壇者の発言であり、一般的な検証済みデータではない点には注意したい。

> この要約・解説記事は、元の音声の文字起こしをもとに AI（Claude）が日本語で作成したものです。出典: Agentic Conversations (formally mlops.community)「Why Stripe Cut 500,000 Internal Docs Down to 5,000?」