仕様駆動開発の組織的定着に向けた取り組み ~『楽楽電子保存』開発チームの事例~ / Establishing SDD: Organizational Initiatives
by
Rakus_Dev
×
Copy
Open
Link
Embed
Share
Beginning
This slide
Copy link URL
Copy link URL
Copy iframe embed code
Copy iframe embed code
Copy javascript embed code
Copy javascript embed code
Share
Tweet
Share
Tweet
Slide 1
Slide 1 text
© RAKUS Co., Ltd. 仕様駆動開発の組織的定着に向けた取り組み 〜『楽楽電⼦保存』開発チームの事例〜 #RAKUS AI Meetup 株式会社ラクス 楽楽明細開発部 開発2課 ⼩栗 朗∕⼭⽥智史 2026/1/22 1
Slide 2
Slide 2 text
© RAKUS Co., Ltd. 2 #RAKUS AI Meetup 登壇者紹介 ⼩栗朗(Akira Oguri) ⼭⽥智史(Tomofumi Yamada) エンジニアマネジャー 楽楽電⼦保存⽴ち上げ‧グローバル開発推進 - 2021年ラクス⼊社 - 前職:メーカー系SIer、パッケージ開発のPMF達成‧基盤刷新 バックエンドエンジニア 楽楽電⼦保存のバックエンド開発 - 2023年ラクス⼊社 - 楽楽電⼦保存のコンテナ化∕データ基盤主導
Slide 3
Slide 3 text
© RAKUS Co., Ltd. 3 プロダクト概要と開発体制 #RAKUS AI Meetup
Slide 4
Slide 4 text
サービス概要とプロダクト品質課題 【サービス概要】 ● 2022年1⽉にリリース ● 電⼦帳簿保存法対応を楽にするクラウドサービス ● AI-OCR+認定タイムスタンプで証憑の真実性担保 ● 楽楽明細連携、検索‧権限管理で⽇々の⼿間削減 4 電⼦帳簿保存法への対応を楽にするクラウドサービス プロダクト品質の課題 当初は早期リリースを最優先。シンプルなビジネス要件のため、DDD採⽤を志向しつつも、ドメイン層が薄くな り、業務判断がサービス層に分散する傾向があった。
Slide 5
Slide 5 text
5 エンジニア バックエンド ブリッジSE ラクスベトナム エンジニア フロントエンド エンジニア PMM/PdM/ デザイナー 楽楽電⼦保存開発体制 PMM‧PdM‧プロダクトデザイナー‧開発(BE/FE) バックエンド開発はラクスベトナムによるオフショア開発 (*) PMM: プロダクトマーケティングマネージャー PdM: プロダクトマネージャー
Slide 6
Slide 6 text
© RAKUS Co., Ltd. 6 開発へのAI活⽤ #RAKUS AI Meetup
Slide 7
Slide 7 text
7 2025年度のAI活⽤の取り組み 2025年4⽉ AI活⽤による 全社スピードアップを掲げる。 各AIツールの本格利⽤。 FY25 上期 個別努⼒によるトライア ル。試⾏錯誤の時期。 FY25 3Q 段階的な成果の刈り取り。 ⽣産性が向上。 Next Step 仕様駆動開発の適⽤など 組織定着へ。 2025年4⽉、AI本格活⽤が始動。 ラクス全体が「発散期」にあり、現場では多種多様な「とりあえずやってみる」を試⾏。
Slide 8
Slide 8 text
設計へのAI活⽤ 8 観点プロンプトによる要件定義∕設計のドラフト⽣成、レビュー 実装に先⽴ち、「要件定義∕設計情報の整理」に AI を活⽤。⼿動運⽤ながら、Google Docs への情報の集約と構 造化を推進。 要件定義∕設計ドラフト⽣成‧レビュー ● PMM∕PdMの要求を1ドキュメントに集約 ● 要求をインプットに ChatGPT / Gemini などでドラフトを⾼速⽣成。 ● 「外部仕様」「内部設計」などの設計観点をプロンプト化し、AI による⾃⼰レ ビューを実施。 ● 結果:設計リードタイムを 30% 短縮
Slide 9
Slide 9 text
実装へのAI活⽤ 1 / 2 9 作成レイヤー単位でカスタム指⽰を整備し、AI⽣成コードの統制 .github/ ├─ copilot-instructions.md // 全体ルール ├─ instructions/ (13種) // Layer別仕様 │ ├─ controller.instructions.md │ ├─ domain.instructions.md │ ├─ repository.instructions.md │ └─ usecase-service.instructions.md ... └─ prompts/ // 作業テンプレ ├─ code_prompt ├─ code_review └─ pr-description 個別のバイブコーディングからカスタム指⽰によるAIでのドラフト⽣成∕レビューのハルシネーションを抑制。 プロンプトのテンプレートも準備し、チーム内での利⽤効率を平準化 # controller.instructions.md(⼀部) ## 禁⽌事項 - Controller にビジネスロジックを書かない - ネストされたif / forを書かない - 関数の連鎖は避ける。ただしOptionalや公式ライブラリによ る標準的チェーンは許容 ## 必須ルール - Controller は Request/Response の変換のみ - 業務処理は UseCase に委譲すること
Slide 10
Slide 10 text
実装へのAI活⽤ 2 / 2 10 レビューやPRの説明をAIで補完し、⽇越開発の効率化 .github/prompts/ ├─ code_prompt.prompt.md // 実装⽀援 ├─ code_review.prompt.md // レビュー⽀援 └─ pr_description.prompt.md // PR説明⽣成 レビュー観点とPR説明もAIで標準化し、レビュー効率を向上。 PR URLから差分を読んで、Why/What/How+アーキテクチャ図(Mermaid)まで⾃動⽣成。 ⽇本側レビューの「背景不⾜」を埋める運⽤となっている # PR説明⽣成(pr_description.prompt.md) ⼊⼒: - PR URL - 出⼒⾔語:JP / VI / BOTH(JPがデフォルト) ⽣成内容(⽇本語): ### What(何を実装したか) - 変更内容の要約 - 追加‧修正された機能の概要 ### Why(なぜ実装したか) - 業務背景 - 要求‧課題‧⽬的 ### How(どのように実装したか)
Slide 11
Slide 11 text
© RAKUS Co., Ltd. 11 オフショア施策とAI開発の親和性∕成果 #RAKUS AI Meetup
Slide 12
Slide 12 text
オフショア開発の最適化は、AI活⽤にも効果 12 当初の⽬的(⼈向け) 多⼈数オフショアを成⽴させるための施策 結果(AI視点で⾒えた価値) AIにとって理想的な⼊⼒構造になっていた • DDDの⾒直し:ドメイン⽋乏解消 / アグリ ゲートパターンの適⽤ • PR単位の最適化:Findy+ を活⽤したレ ビュー負荷抑制の運⽤改善 • サブシステム分割:電⼦保存本体と各連携処 理などの責務の分離 • ⼊⼒トークンの抑制:責務が単⼀、PR差分 が限定的、サブシステムで完結 -> 今後、トークン使⽤量の抑制に効果も AIが迷わない:ドメイン境界が明⽰的で推論 範囲が局所化 • ベトナム開発とのコミュニケーションを円滑にするため、情報を⼩さく‧明確に渡す「スモールコンテキスト」 環境を整えてきた結果が、AI活⽤における⼟台に。
Slide 13
Slide 13 text
成果:開発サイクルとマージ頻度の改善 13 PR単位の適正化による好循環:AI活⽤で実装スピードを上げつつ、運⽤としてPRを⼩さく保つことで 開発サイクル全体の改善を実現。 PR単位のサイクルタイム:1/3へ短縮 (300h超 → 113h) FY2024 4Q とFY2025 3Q⽐較 本番製品ブランチへのマージ頻度:6倍 0.5 → 3.0回/週 ※ ※リリース可能な機能単位でのマージ数。開発中ブランチへのマージは⽇々発⽣
Slide 14
Slide 14 text
成果:開発量の増加 14 開発サイクルタイムの改善だけでなく、開発量においても増加 指標 FY24 四半期平均 FY25 四半期平均 増加率 開発⾏数 21.7K 59.0K +171% API修正 37 ※新規∕改修含む 91 +147% テストファイル数 129 ※新規∕改修含む 563 +335% 本取り組みでは、単⼀のKPIではなく「開発量‧サイクル‧品質」の複数指標を組み合わせて評価している。 ⼀部の数値だけを⾒ると誤解を⽣むため、全体像で判断
Slide 15
Slide 15 text
© RAKUS Co., Ltd. 15 より洗練したAI活⽤に向けた取り組み #RAKUS AI Meetup
Slide 16
Slide 16 text
AIとつなぐ「仕様駆動開発」への関⼼ 16 ⽣成‧レビューの次は、「要件 → 実装」を分断しない世界観に 現状 理想 ✔AIで設計∕コードのドラフト⽣成、 レビューでは既に戦⼒化 ✔要件定義〜設計〜実装は分断されたまま 仕様を書けばAIが実装を形に 要件とコードが常に同期された状態
Slide 17
Slide 17 text
仕様駆動開発への挑戦と課題 17 絶賛、苦悩中 課題 ● 仕様関連ドキュメントが GitHub 外で形式もばらつきがあり、MCPにより参照はしつつも、⼿動運⽤は多い ● 仕様駆動のオープンソースツールはトライアル中だが、電⼦保存の開発においてはドキュメント過多に ○ 思想やツールは素晴らしいが、実務適⽤が難しい ● チームで「AI に指⽰し、放置して後で確認」という状態には⾄っておらず、AI 出⼒を同期的にチェック 仕様駆動開発の今後の⽅向性として、AIツールに合わせて、開発と運⽤プロセスをアジャストする。 Copilot / ClaudeなどのInstructions / Prompts / Skills を整理‧最適化し、AIに任せる判断や作業の範囲を明確 にすることで、 仕様駆動開発を実運⽤として成⽴させていく
Slide 18
Slide 18 text
© RAKUS Co., Ltd. 18 ご清聴ありがとうございました。 #RAKUS AI Meetup