HQ駆動開発で最高のAI-Contextを作ろう

■イベント
FlutterKaigi
https://2026.flutterkaigi.jp/

■登壇概要
タイトル：HQ駆動開発で最高のAI-Contextを作ろう
登壇者：技術本部 Bill One EX プロダクト開発部 Mobile Applicationグループ ヤズジュ 夢佐

■ 技術本部 採用情報
https://media.sansan-engineering.com

Transcript

1. HQ駆動開発で 最⾼のAI-Contextを作ろう Sansan株式会社 技術本部 Bill One EX プロダクト開発部 Mobile Applicationグループ ヤズジュ 夢佐
2. ヤズジュ 夢佐（Musa Yazici） 技術本部 Bill One EX プロダクト開発部 Mobile Application Group 主な技術領域はiOSアプリ開発。 2026年からFlutterアプリ Bill One経費 開発チームに移る。
3. Bill One経費アプリについて - 今回の話の前提となる、Android/iOS対応のFlutterアプリ - クラウド経費精算サービス - 経費確認‧申請や、証憑の撮影、 発⾏したクレジットカード表⽰‧ 利⽤明細確認などが可能
4. 抱えていた課題
5. 関連リポジトリが読めない - モバイルアプリの実装はリポジトリにあり、その中はAIも読める - しかし、バックエンドや認証基盤は別のリポジトリにある - AIがスムーズに読みにいくことができない - AIが⾊々なリポジトリを漁り回って苦労したり、 コードを読みにいくのを諦めて推測でそれっぽいコードを書く、 といったことが発⽣していた
6. モバイルアプリに関わるリポジトリ⼀覧 - BillOneExApp # モバイルアプリ - bill-one-ap # Accounts Payable: 請求書受領 - bill-one-ar # Accounts Receivable: 債権管理 - bill-one-ex # Expense: 経費精算 - bill-one-sp # Service Platform: 共通基盤 - bill-one-mobile-bff # モバイルアプリ⽤BFF (Backend for Frontend) - auth-one-mobile-sdk # 認証SDK - auth-one # 認証基盤 これらのリポジトリを必要に応じて読める状態にしないと、AIによる正確でスムー ズな実装ができない
7. どうやって関連リポジトリを読ませるか？
8. submoduleはどうか？ - 親が⼦のcommitを固定する仕組みなので、全てのリポジトリを特定のcommit hashに紐づける必要がある - 定期的にcommit hashを更新しなきゃいけないのが⾯倒だったり、⼈によって別の branchを⾒たい時に差分が出てしまい、管理が⼤変 - git status / git pull などが、親に紐づいた全リポジトリ分になり、重たい - worktreeを作れば作るほどそれが重複してAI contextに乗ってしまい、重たくなる - CursorはルートにあるSkillしか認識しないので、配下のリポジトリのSkillを⾃動で 読みに⾏けない
9. VSCode Multi-root Workspaces
10. VSCode Multi-root Workspacesで解決 - 開発メンバーは全員Cursorで開発作業をしているため、 VSCode 標準機能が活⽤できる - submoduleで発⽣する多くの課題が解決できる - .code-workspace fileによってworkspaceに含めたい folderを⾃由にカスタマイズできる - .code-workspaceの定義が⼊ったHQ (Headquarter) リ ポジトリを⽤意する - https://code.visualstudio.com/docs/editing/workspac es/multi-root-workspaces
11. submoduleで抱える多くの問題を解消 1. commit hash管理の煩雑さ -> 全てのリポジトリが独⽴したfolderのため、柔軟にbranchを切り替えたりリポジト リを更新することが可能。⼈によって別々のhashを⾒てもHQに差分が出ない 2. git操作の重さ -> リポジトリごとにgit操作が独⽴するので軽い 3. worktreeが重複してAI contextを圧迫 -> .code-workspaceに置いたfolderだけがcontextに乗るので、重複を防げる 4. CursorはルートにあるSkillしか認識しない -> .code-workspaceにMulti-rootで定義できるので、複数のrepoのskillを読ませられる
12. Multi-root Workspacesを活⽤したHQで得られた恩恵 - リポジトリを横断した不具合や仕様の調査がスムーズに⾏えるようになった - AIが他リポジトリを参照しつつ正確に実装できるようになった - 他のリポジトリの不具合修正も気軽に⾏いやすくなった ぜひお試しください！
13. ありがとうございました！