技術負債を抱えていても実践できる！ドキュメント駆動で始めるAIコーディング

1. 技術負債を抱えていても実践できる！ ドキュメント駆動で始めるAIコーディング DevelopersIO Nagoya Day One 株式会社コラボスタイル 清水隼人
2. 自己紹介
3. 名 前 ： D o （ 清 水 隼 人 ） 広 島 県 在 住 所 属 ： 株 式 会 社 コ ラ ボ ス タ イ ル 　 　 バ ッ ク エ ン ド エ ン ジ ニ ア 　 　 　 ( 2 0 2 5 年 3 月 入 社 ) 趣 味 ： キ ー ボ ー ド な ど の ガ ジ ェ ッ ト 　 　 　 宮 島 、 マ ラ ソ ン 自 己 紹 介 (自己ベスト3時間1分35秒) 元競馬場誘導場担当 X:@tanimotoikki
4. 向き合うプロダクトと 仕事上の課題
6. コ ラ ボ フ ロ ー 1 2 年 以 上 運 用 さ れ て い る サ ー ビ ス 一 部 で レ ガ シ ー コ ー ド ワ ー ク フ ロ ー サ ー ビ ス の 知 見 が 詰 ま っ て い る D o ( 清 水 ) 6 か 月 前 に 入 社 S a a S メ ー カ ー に 初 挑 戦
7. 仕事を進めていく中での課題 レガシーな言語での開発 バックエンドの調査に時間がかかる コードだけでなく、ドキュメントも膨大 Vibeコーディングなどを試すも思うようにはならない
8. 開 発 の 速 度 が 上 が ら な い 安 定 し な い
9. 課題解決の糸口
10. コーディングエージェントの進化 C l o u d e C o d e ， K i r o の 登 場 × プ ロ ン プ ト → コ ー ド 〇 プ ロ ン プ ト → ド キ ュ メ ン ト → コ ー ド ド キ ュ メ ン ト 自 体 も A I に 書 か せ る 事 例 エ ー ジ ェ ン ティ ッ ク コ ー ディ ン グ
11. AI-DLC(AI-Driven Development Life Cycle) A I が 実 行 し 、 人 間 が 監 視 を す る A I 中 心 の 開 発 ア プ ロ ー チ https://aws.amazon.com/jp/blogs/news/ai-driven-development-life-cycle/
12. 工 夫 す る と 負 債 が あ る 環 境 で も A I 活 用 効 果 が 上 が る の で は な い か … ？
13. 開発のステップ
14. 開発ステップ 調査をする 課題を作成 仕様を定義 実装
15. 調査結果 コード 定義した課題 追加の技術情報 コーディング規約 調査をする 課題を作成 仕様を定義 実装 コードの調査 調査内容の精査 追加調査の依頼 開発ステップ
16. コードの調査 調査内容の精査 追加調査の依頼 課題の文書作成 課題の精査 不足している情報 の追加 調査結果 ブラッシュアップ した課題の文書 調査をする 課題を作成 仕様を定義 実装 コード 定義した課題 追加の技術情報 コーディング規約 開発ステップ
17. コードの調査 調査内容の精査 追加調査の依頼 課題の文書作成 課題の精査 不足している情報 の追加 仕様の文書作成 個別の技術仕様書 作成 仕様書の確認 技術仕様について は別途整理を指示 調査結果 ブラッシュアップ した課題の文書 課題の全体仕様書 詳細な技術仕様書 調査をする 課題を作成 仕様を定義 実装 コード 定義した課題 追加の技術情報 コーディング規約 開発ステップ
18. コードの調査 調査内容の精査 追加調査の依頼 課題の文書作成 課題の精査 不足情報の追加 仕様の文書作成 個別の技術仕様書 作成 仕様書の確認 技術仕様について は別途整理を指示 課題の実装 実装内容の確認 AIができない箇所 を補助 調査結果 ブラッシュアップ した課題の文書 課題の全体仕様書 詳細な技術仕様書 実装コード 実装レポート 調査をする 課題を作成 仕様を定義 実装 コード 定義した課題 追加の技術情報 コーディング規約 開発ステップ
20. この手法で注意する点 指 示 を ご く ご く 小 さ い 範 囲 に す る 例 ） 範 囲 指 定 し 「 リ フ ァ ク タ リ ン グ の 提 案 を し て く だ さ い 。 コ ー ド の 修 正 は し な い で く だ さ い 」 A I の 生 成 し た 文 書 を 理 解 し 、 慎 重 に チ ェ ッ ク を す る 生 成 A I は 行 間 を 読 む こ と は で き な い 人 間 が 修 正 し た 場 合 は 読 み 込 み の 指 示 を す る 再 読 み 込 み を し な い と 以 前 の コ ン テ キ ス ト で A I は 認 識 す る
21. 解決したこと しなかったこと
22. 解 決 し た こ と
23. この手法で解決したこと A I が 生 成 す る コ ー ド の 精 度 が 向 上 こ の 手 法 を 手 に 入 れ て か ら コ ー ド を す べ て 不 採 用 が 手 戻 り が 減 り 課 題 の 実 装 時 間 が 縮 減 1 日 ( 6 時 間 ) で 見 積 も っ た 課 題 → ０件 2 時 間 削減時間 削減時間 66.7% 実装時間 33.3%
24. 解 決 し な か っ た こ と
25. この手法で解決できなかったこと デ バ ッ グ な ど 、 細 か い 精 度 を 上 げ る と こ ろ は 苦 手 A I 7 0 % 問 題 ド キ ュ メ ン ト と コ ー ド の 細 か い チ ェ ッ ク が 必 要 7 0 % を 8 0 % ～ 9 0 % ま で 引 き 上 げ る た め に は 事 前 の 作 業 が 必 要 細 か い 修 正 だ と 時 間 が か か る
26. ま と め
27. まとめ エ ン ジ ニ ア が 普 段 か ら 当 た り 前 に や っ て い る こ と を 一 つ 一 つ A I と 伴 走 し て ド キ ュ メ ン ト を 出 力 し な が ら 進 め て い く と 、 技 術 負 債 が あ る 環 境 で あ っ て も A I が う ま く 使 え る ！
28. ド キ ュ メ ン ト 駆 動 な 開 発 で 、 あ な た も A I フ ァ ー ス ト の 開 発 を
29. 「 ワ ー ク ス タ イ ル の 未 来 を 切 り 拓 く 」 を 企 業 理 念 に 会 社 の ワ ー ク フ ロ ー シ ス テ ム の 開 発 や 、 働 く 場 所 と な る リ ア ル オ フ ィ ス 環 境 作 り の 事 業 を し て い ま す ！ Do（清水）Xアカウント コラボフロー製品サイト
30. thanks!