AI駆動開発で崩れていくコードベースを立て直す

AI 駆動開発で崩れていくコードベースを立て直す 1

自己紹介 X: @kyoko_NR_nr 北川杏子フロントエンドエンジニア特技: 韓国語コロナ禍に暇だったので1日8時間K-POPの Youtubeを見続けたらいつの間にか話せるようになっていた
2

1. 非エンジニアの夫、Webアプリを作るある日、非エンジニアの夫がAIでWebアプリを作っていたちゃんと動いている。すごい…！せっかくなのでちゃんと作るため、本格的に手伝うことにやってみると問題が続出した。それらに四苦八苦して対応した記録 17

2. 動くけど 18

問題動いているように見えるけど、実際に中を見てみるとなかなかのカオス不要なライブラリが大量に依存関係に含まれていた同じような機能のライブラリが重複していた逆に必要な機能は仮実装のままバックエンドが必要なアプリだったが、データベースなどは作られてない 19

対応不要なライブラリを削除 READMEの整備使われていないコードを削除リンター・フォーマッターを導入 AI用のドキュメント整備（Rules）ディレクトリ構成の整備（フィーチャーベース構成）技術選定ベースがごちゃついてるとAIもごちゃついたコードを出力しがちなので、整理して最低限の構成に
まずは最低限の環境構築 20

3. PRが見切れない最低限の整備ができたので 1. 夫がバイブコーディングする 2. 自分がPRレビューをする。修正は自分でやってマージというサイクルにしようと思ったが… 21

問題 PRの差分が大きすぎて読みきれない 1日に5件以上のPRが作成されるせっかくPRレビューで修正した機能が、やっぱいらなくなった / 全然別の機能にしたくなった、が多発 → 夫婦ケンカ勃発 22

対応リポジトリを分けた PoC用リポジトリ: レビューはしない。とにかく作って壊してを繰り返す開発用リポジトリ: PoCをAIに読ませて、ページ単位/機能単位で移植していくとりあえず作るものとちゃんと作るものを分ける 23

4. 要件確認とリファクタ PoC用リポジトリを分けたので、これでコードの治安は守られる…と思ったが 24

問題 PoCは一見それっぽく見えるけど、よくよく考えると機能が足りてなかったりする例）画像の登録機能はあるけど削除機能がない。ログイン機能はあるけどログアウトはない PoCをただ移植するだけでは保守性/可読性/セキュリティの面でよくない例）1ファイル1000行のコード、フロントエンドから直でDB操作 25

対応要件は都度確認ドキュメントを起こす時間はないので、OpenSpecで仕様を同時にmdファイルにしていく ※OpenSpec = 仕様駆動開発用のライブラリリファクタリング大きすぎるコンポーネントは、まずAIにテストを書かせる分割してテストを実行
= OKなら壊れてない、と判断 AIに任せず、理解するためにも手で実装する時間を設けた 26

5. プロジェクト用のルール・スキルは都度ブラッシュアップ何とか開発サイクルは回るようになった。ただ、 27

問題 AIに何度も同じ指示をするどうしても既存のコードのスタイルに引きずられてしまう 28

対応ルールの追加何度も行う指示はAI用のルールにどんどん追加していくリントルールで強制機械的にチェックできそうなことは、AIにオリジナルのリントルールを書かせて強制するプロジェクト用のスキルを作る例）リファクタリング専用スキル AIのプランと手で実装したところの差分を読ませ、リファクタの時に何を大切にしているか・どんな思想かを言語化しスキル化
フローを固定化実装の前にまずリファクタリングプランを必ず出すフローにするあとが楽になる 29

まとめ AI駆動開発でも、整備しなければコードベースはどんどん崩れていく問題が起きたら「仕組み」で解決することを心がける非エンジニアがAIを使って動くものを作れるのは素直にすごいだからこそ、最後は自分自身の知識・判断が必要 30

AI駆動開発で崩れていくコードベースを立て直す

AI駆動開発で崩れていくコードベースを立て直す

Kyoko NR

Other Decks in Programming

Featured

Transcript