生成AI時代のドキュメントに対する期待の整理と実践から得た学び / Rethinking Documentation for LLM: Lessons from Practice

2 Copyright © 2025 Bitkey Inc. All right reserved. 自己紹介
2015.04 2019.05 2020.01 大学(建築学専攻)卒業後、株式会社ワークスアプリケーションズに入社会計システムのソフトウェア開発を担当特に財務会計の仕訳関連ビットキーへ参画 ECサイトの開発 / 保守、社内システムの開発 TaKuTyの開発今のhomehub事業の前身となるResidenceチームに配属。スマートロックを扱う管理画面やバックエンド、スマホアプリの開発に従事 Now homehub事業のプロダクト責任者複雑な事象を読み解いて構造化し、抽象化 / 汎用化できるように設計し、低コストで多くの価値をだせる開発をすることを好む佐藤拓人 Sato Takuto @takuuuuuuu777

佐藤拓人 Sato Takuto @takuuuuuuu777 Before After

佐藤拓人 Sato Takuto @takuuuuuuu777

5 Copyright © 2025 Bitkey Inc. All right reserved. homehubは「暮らし」に関わる様々な体験を実現する。その中心にあるのがスマートロック
0. はじめに「暮らし」

6 Copyright © 2025 Bitkey Inc. All right reserved. 0.
主張

主張ドキュメントの目的を明確にし、読み手とそのコンテキストの解像度を上げることが大切！

課題

課題書く側のコストは劇的に下がった。しかし、ドキュメントが増えた分読む側・レビューする側は負担が増え疲弊していませんか？読む側・レビューする側のコストが増える要因

課題読む側・レビューする側のコストが増える要因知っていること

課題要因1：言語化のズレ

課題要因1：言語化のズレ言語のズレは、ドキュメントの「正しさ」への信頼を破壊するレビュアー

課題要因2：前提の欠如と情報過多

課題要因2：前提の欠如と情報過多誰向けの情報か？混ざり合うコンテキスト

課題要因3：段階的開示の欠如

課題要因4：視覚化の欠如

課題まとめ段階的開示の欠如視覚化の欠如【推測コスト】 (これは何をさしているのか？) 【判別コスト】 (これは自分に重要か？) 【把握コスト】 (全体としてどういう方向か？) 【理解コスト】 (つまりどういうこと？)

ユビキタス言語の整理

ユビキタス言語の整理用語のズレがもたらす「信頼の喪失」

ユビキタス言語の整理用語のズレがもたらす「信頼の喪失」「入居者が自身の部屋にカードを登録したら、マンションのエントランスも同じカードで解錠できるうにしたい」

ユビキタス言語の整理特にユビキタス言語を整理することで、「つなげる」ことができる

ユビキタス言語の整理ドメイン知識の構造的整理ユビキタス言語だけでなく、ドメイン知識全般を整理しておくで、 AIの成果物をより低コストで理解できるようにできる

意義とフォーマットの整理

意義とフォーマットの整理 AIの出力は冗長となりやすい

意義とフォーマットの整理多かなプロセスを整理しつつ、ドキュメントの意義を整理する

意義とフォーマットの整理書くべきことを精査して、フォーマットを規定する

意義とフォーマットの整理書かないことを規定する

ターゲットが人間 / AI、で分離

ターゲットが人間 / AI、で分離 AI / 人間要求整理

ターゲットが人間 / AI、で分離人間に対しては、正確性より視認性が重要となる場合もある

全体のプロセス設計〜AIと人間の役割分担〜

全体のプロセス設計〜AIと人間の役割分担〜 AIと人間の役割分担

全体のプロセス設計〜AIと人間の役割分担〜人間が介在する箇所を戦略的に限定することで、認知負荷を低減させる

まとめ

まとめ ◼ まとめ・ドキュメントの目的を明確にし、読み手とそのコンテキストの解像度を上げる・前提として、用いる言語や前提知識は揃える・目的によって必要な情報は異なる。プロセスを定め目的を限定した上で、フォーマットやサンプル、記載　ポリシーなどを用いて、情報を限定させる・AIと人間とで、適切な情報の構造は異なる。AI向けの情報を一次情報としつつ人間が視認しやすい形式で　別途情報を構成し直す ◼ 気づき・いろいろ考えた結果、AI / 人間問わず、どんな使い方を想定するか、どんな知識が前提となっているかを　慮ってよりよい形式に想いを馳せられるかが重要であると考えます

生成AI時代のドキュメントに対する期待の整理と実践から得た学び / Rethinking Do...

生成AI時代のドキュメントに対する期待の整理と実践から得た学び / Rethinking Documentation for LLM: Lessons from Practice

More Decks by 株式会社ビットキー / Bitkey Inc.

Other Decks in Technology

Featured

Transcript