AI活用するためのドメイン知識を泥くさく整理する / Putting in the Work to Organize Domain Knowledge for AI

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

佐藤拓人 Sato Takuto

佐藤拓人 Sato Takuto @takuuuuuuu777

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

6 Copyright © 2025 Bitkey Inc. All right reserved. 0.
はじめに

課題

課題 AI活用うまくいっていますか？

課題 AI活用うまくいっていますか？残念ながら私は NO

課題期待と現実のギャップ・AI-DLCや仕様駆動開発などを試してみてそれなりのことはできる・ただしちゃんと人間が事前に道筋(仕様)を整理しておく必要があった・求めているのはそういうことではない・AIがいるからこそ、要件の不整合さやユースケースの漏れを事前に検知したり　よりよいテスト戦略を講じられるようになりたい → 一緒に仕様を作り上げたい！

課題期待　入居者が自身の部屋に交通系ICカードを登録したら、マンションのエントランスも同じカードで解錠できるようにしたい！　エントランスに設置されている連携デバイス経由で、エントランスの解錠デバイスを解錠するための認証データを認証デバイスに配信して！

課題期待　入居者が自身の部屋に交通系ICカードを登録したら、マンションのエントランスも同じカードで解錠できるようにしたい！　エントランスに設置されている連携デバイス経由で、エントランスの解錠デバイスを解錠するための認証データを認証デバイスに配信して！・退去したらどうする？・連携デバイスがない場合は？・デバイスの設置状況は？・ネットワークが不安定だったら？・複数のエントランスがあったら？・複数の部屋に入居していたら？・家族や同居人の交通系ICカードも対象？

課題期待　入居者が自身の部屋に交通系ICカードを登録したら、マンションのエントランスも同じカードで解錠できるようにしたい！　エントランスに設置されている連携デバイス経由で、エントランスの解錠デバイスを解錠するための認証データを認証デバイスに配信して！・退去したらどうする？・連携デバイスがない場合は？・デバイスの設置状況は？・ネットワークが不安定だったら？・複数のエントランスがあったら？・複数の部屋に入居していたら？・家族や同居人の交通系ICカードも対象？より良い仕様を策定するためにナビゲートして欲しい

課題期待　入居者が自身の部屋に交通系ICカードを登録したら、マンションのエントランスも同じカードで解錠できるようにしたい！　エントランスに設置されている連携デバイス経由で、エントランスの解錠デバイスを解錠するための認証データを認証デバイスに配信して！・退去したらどうする？・連携デバイスがない場合は？・デバイスの設置状況は？・ネットワークが不安定だったら？・複数のエントランスがあったら？・複数の部屋に入居していたら？・家族や同居人の交通系ICカードも対象？ぜんぜんできない ...

課題期待　入居者が自身の部屋に交通系ICカードを登録したら、マンションのエントランスも同じカードで解錠できるようにしたい！　エントランスに設置されている連携デバイス経由で、エントランスの解錠デバイスを解錠するための認証データを認証デバイスに配信して！・退去したらどうする？・連携デバイスがない場合は？・デバイスの設置状況は？・ネットワークが不安定だったら？・複数のエントランスがあったら？・複数の部屋に入居していたら？・家族や同居人の交通系ICカードも対象？なんでだろう？

課題期待と現実のギャップ背景となるドメイン知識が圧倒的に不足していたから・残念ながら社内に整理されてドキュメントはなし。全くないわけではないが、整理されておらず、古いまま更新されていないものも多くある。・ソースコードから推論もできるが、精度は高くなく的外れな解釈することも多くてつらい以下のような状態からスタートとなってしまう... ・入居者って？賃貸マンションなの？分譲なの？それとも戸建？・部屋に交通系ICカードを登録するってどういうこと？・マンションのエントランスってどういう仕組みで解錠できるの？・解錠デバイス、連携デバイス、認証デバイス、認証データってなに？

課題視野を広げて自律的に動くために必要なもの = 「地図」　　　　　　　　　　　　　　　　　　　　 = 「構造化されたドメイン知識」

はじめに

Section Title Page Title Sample

方針

方針取り組んだこと3選 1:知識の精査と構造化 2:雛形とポリシー作成 3:チーム組織への展開 (進行中) ・構造化して、低コストで管理運用するた　めの土台を整備・情報が散らかると、更新や妥当性の判断　がしづらく、参照時のトークンやコンテ　キスト観点で害悪となりえる・「何を書き、何を書かないか」を型決め・情報の純度を高めるために慎重に剪定す　る「あったら良い情報」でなく「ないと　困る」情報に限定する・価値発揮をするため個人活用に留めない・継続的に更新しつづけるようにするため　に、チームや組織での活用と日々の開発　プロセスに組み込んでいく必要がある

知識の精査と構造化・構造化して、低コストで管理運用するための土台を整備・情報が散らかると、更新や妥当性の判断がしづらく、参照時のトークンやコンテキストで害悪となりえる・AIと対話を重ねて構造を整理し、管理しやすさや参照時の迷いづらさを考慮 2. 方針

知識の精査と構造化・構造化して、低コストで管理運用するための土台を整備・情報が散らかると、更新や妥当性の判断がしづらく、参照時のトークンやコンテキストで害悪となりえる・AIと対話を重ねて構造を整理し、管理しやすさや参照時の迷いづらさを考慮 2. 方針事業やプロダクトの概要 Mission / Visionなど事業として関心のある領域ざっくりどんな領域があるかを整理し、全体の地図として機能できるように日常的に扱っている言語ラフな会話でも正しく解釈 & 出力できるように

知識の精査と構造化・構造化して、低コストで管理運用するための土台を整備・情報が散らかると、更新や妥当性の判断がしづらく、参照時のトークンやコンテキストで害悪となりえる・AIと対話を重ねて構造を整理し、管理しやすさや参照時の迷いづらさを考慮 2. 方針システム的な境界責務がどのように分散されているかがわかり、適切な領域にアクセス可能に提供しているアプリケーションやデバイスごとの情報システム全体の構成や詳細な実現方法

雛形とポリシーの作成・構造化したうえで、ドメイン知識を整える際には、当然LLMを活用する・しかし...虚偽の情報は含めたくないし、純度の高い状態をできれば維持したい・分類ごとに最初の2ファイルは全力で自身で記載して、その後2-3ファイルは　「AIに書かせる」→「添削する」→「スキル更新」…繰り返しを実施した・特に添削時に「あったら良い情報」は除外して、「ないと困る情報」に限定するようにする 2. 方針

雛形とポリシーの作成・ソースコードから推測が容易な情報は対象外とし、より普遍的な背景やユースケースなどの情報に集中・記載ポリシーを適宜更新してできるだけLLMだけで質の高い情報を整理できる状態に・しかし人間側も全てを言語化できるわけではないので、雛形・サンプルをまずはきっちり作成する 2. 方針

チーム組織への展開 2. 方針ドメイン知識ドメイン知識開発プロセス活用更新・ドメイン知識は継続的に更新していく必要がある・日々の開発で活用して、更新することで理論上は実現できる・個人で実践するだけでなく、チームや組織単位で実践することで加速させることができる

チーム組織への展開 2. 方針ドメイン知識ドメイン知識開発プロセス活用更新・ドメイン知識は継続的に更新していく必要がある・日々の開発で活用して、更新することで理論上は実現できる・個人で実践するだけでなく、チームや組織単位で実践することで加速させることができる・ただし...課題もある...

チーム組織への展開 2. 方針ドメイン知識ドメイン知識開発プロセス活用更新・ドメイン知識は継続的に更新していく必要がある・日々の開発で活用して、更新することで理論上は実現できる・個人で実践するだけでなく、チームや組織単位で実践することで加速させることができる・ただし...課題もある... ・更新が面倒くさくて、実施されない・AI活用するとしても、口頭のコミュニケーションがベースだとつらい・「これ」「あれ」のような指示語が多く抽出できる情報が限定的

チーム組織への展開 2. 方針ドメイン知識ドメイン知識開発プロセス活用更新・ドメイン知識は継続的に更新していく必要がある・日々の開発で活用して、更新することで理論上は実現できる・個人で実践するだけでなく、チームや組織単位で実践することで加速させることができる・ただし...課題もある... ・更新が面倒くさくて、実施されない・AI活用するとしても、口頭のコミュニケーションがベースだとつらい・「これ」「あれ」のような指示語が多く抽出できる情報が限定的・無意識に自身の暗黙知で補完してしまいがちで、管理されている情報の不備や不足に気づきづらい、というか気づけない

チーム組織への展開 (試行中) 2. 方針ドメイン知識ドメイン知識開発プロセス活用更新・課題を解決するため開発の中心をAIにおくことが必要・AIは管理されているドメイン知識をベースとするため、不足や不備に気づきやすい・開発者は不足や不備を指摘して、あとでAIに指摘事項をまとめさせて更新してもらう指摘

チーム組織への展開 (試行中) 2. 方針・実現するためにも最初から最後のプロセスをAIを中心に据え置く必要がある・実現するために開発プロセスやスキルの整備を実施・個人ワークよりも、ペアタスクの比重を高めて普及を促進ドメイン知識

結果・気づき

結果・気づき ◼ 良かったこと・バックログアイテムの作成など、プロダクトマネージャーも簡単にできるようになった・問い合わせ対応の分析やPlaybookなども充実させやすくなった・開発過程でのアウトプットの認知負荷を下げることができた ◼ 気づき・わかっているつもりで、「わかっていない」「整理できていない」ことがたくさんある... ・AIが整理する情報は冗長になりがち、「それっぽいことに流されない」心構えが必要・個人ではなく、チームや組織への取り組みに昇華するのはやっぱり大変... ・AIで簡単にできるものも多いが、最初の仕組みづくりは全力で取り掛かる必要がある

結果・気づき

AI活用するためのドメイン知識を泥くさく整理する / Putting in the Work ...

AI活用するためのドメイン知識を泥くさく整理する / Putting in the Work to Organize Domain Knowledge for AI

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

Other Decks in Technology

Featured

Transcript