AI駆動で継続的にコンテキストを改善する 仕組み作り/AI-context-link-and-motivation

リンクアンドモチベーション登壇資料（2025/11/23）
AI駆動で継続的にコンテキストを改善する仕組み作り
#AI#リンモチ

===========================================
【イベント情報】
■イベントページ
https://creator-square.connpass.com/event/373822/

【株式会社リンクアンドモチベーション】
■お問合せ先
　engineer_pr@lmi.ne.jp
■テックブログ
　https://link-and-motivation.hatenablog.com/
■開発組織の公式X
　https://x.com/LinkandM_dev
=============================================

Transcript

1. © Link and Motivation Group 株式会社リンクアンドモチベーション Developer Productivityユニット プラットフォーム推進グループ 野田 将太 AI駆動で継続的にコンテキストを改善する 仕組み作り
2. © Link and Motivation Group 自己紹介
3. 3 © Link and Motivation Group 野田 将太（@node_shh） 株式会社リンクアンドモチベーション Developer Productivityユニット プラットフォーム推進グループ ソフトウェアエンジニア 自社で開発しているサービス群の共通基盤の開発をやっています。 趣味：スポーツ観戦（格闘技、F1、競馬） 自己紹介 ※結婚式の写真を見直して、顔が赤すぎてびっくりしました
4. © Link and Motivation Group 本題
5. 5 © Link and Motivation Group みなさん
6. 6 © Link and Motivation Group AI駆動開発やってますか？？
7. 7 © Link and Motivation Group AI活用状況 弊社の開発組織では、 7割近くのPRがAIで全てのコードを書いています。 79%! ! 65% 6月 7月 8月
8. 8 © Link and Motivation Group AI活用する中で分かったこと コンテキストエンジニアリングの重要性
9. 9 © Link and Motivation Group 「LLMがタスクを合理的に解決できるように、 必要なすべての文脈情報を提供する技術」 広木 大地著「AIエージェント 人類と協働する機械」 より コンテキストエンジニアリングとは？
10. 10 © Link and Motivation Group コンテキストエンジニアリングとは？ これまで 『経営トップが本気を示す』 AI駆動開発 設計書 コード 開発に必要な情報
11. 11 © Link and Motivation Group コンテキストエンジニアリングとは？ これまで 『経営トップが本気を示す』 AI駆動開発 設計書 コード コンテキスト AIも人間と同じく体系化された情報が必要
12. 12 © Link and Motivation Group コンテキストをどうやって渡すか 私の開発チームでは開発リポジトリ内にドキュメン トを配置し、コンテキストとして渡している • データモデル • 仕様書 • アーキテクチャ図
13. 13 © Link and Motivation Group コンテキストについての弊社の課題 課題1： ドキュメントの情報が古くなる問題 課題2： ドキュメントのメンテナンスコスト高い問題 課題3： 不要な情報が増えすぎる問題
14. 14 © Link and Motivation Group コンテキストについての弊社の課題 課題1： ドキュメントの情報が古くなる問題 課題2： メンテナンスコスト高い問題 課題3： 不要な情報が増えすぎる問題 この2つを解決する仕組みを作りました！
15. 15 © Link and Motivation Group アウトプットの概要 実装完了！ Step1 変更内容をドキュメントに反映 Step2 PRを作成する Step3 実装完了後のコンテキストアップデートフロー（before） PR
16. 16 © Link and Motivation Group アウトプットの概要 Step1 実装完了！ Step1 AIが差分を元にドキュメントを更新&PR作成 PR 実装完了後のコンテキストアップデートフロー（after）
17. 17 © Link and Motivation Group どうやって実現しているか？ 1.PRをMergeする Github Actions 2.差分を確認 3.差分をAIに渡す 4.差分を元にdocを更新 5.PRを作成
18. 18 © Link and Motivation Group 出力されるドキュメントの例 PRの変更内容 「部署」が削除された際の挙動を変更！ 具体的には... • 部署削除時のフローに「影響するテーブルへの反映処理」を追加 開発者 AI
19. 19 © Link and Motivation Group 開発者 具体的な出力内容例 PRの変更内容 「部署」が削除された際の挙動を変更！ 具体的には... • 部署削除時のフローに「影響するテーブルへの反映処理」を追加 変更後の処理フロー docs/use_cases/UC008_組織構造の削除.md AI
20. 20 © Link and Motivation Group # ドキュメントの更新タイミング ・ActiveRecordのモデル追加・インターフェース変更時 ・新たなユースケースが追加された場合 ・既存のユースケースの処理フローに変更がある場合 # ドキュメントの更新が不要なケース ・外部から見た振る舞いが変わらない場合（リファクタリング） … プロンプトで工夫が必要だったポイント ドキュメントの 「更新が必要なタイミング」と「更新不要なタイミング」を明記しておく 更新不要なタイミングも入れておくと、 更新頻度を抑えられる
21. 21 © Link and Motivation Group 解決したこと 課題1： ドキュメントの情報が古くなる問題 課題2： ドキュメントのメンテナンスコスト高い問題 課題3： 不要な情報が増えすぎる問題
22. 22 © Link and Motivation Group 解決したこと 課題1： ドキュメントの情報が古くなる問題 課題2： ドキュメントのメンテナンスコスト高い問題 課題3： 不要な情報が増えすぎる問題 改善点： マージされるたびにドキュメントが更新される 改善点： レビューコストのみ 更新漏れゼロ！ 人間が参照するドキュメントとしても活用できる！
23. 23 © Link and Motivation Group これから改善が必要な点 課題1： ドキュメントの情報が古くなる問題 課題2： ドキュメントのメンテナンスコスト高い問題 課題3： 不要な情報が増えすぎる問題
24. 24 © Link and Motivation Group これから改善が必要な点 課題3： 不要な情報が増えすぎる問題 ドキュメント量が多くなりがちで、 ある閾値を超えると精度が下がってしまう可能性がある。 棚卸しの仕組みが必要
25. 25 © Link and Motivation Group コンテキスト管理を仕組み化し、 継続的にAIのアウトプットの質を高よう 最後に