VISASQ Dev Blog

ビザスク開発ブログ

生成AI でドキュメント 駆動開発をやってみた

検索チームの tanker です。 先月会社の自己啓発休暇制度を使いチェコのチェスキー・クルムロフに行ったのですが、早朝の人や車が全くいない街歩きはとても癒されました。

チェスキー・クルムロフ

2026/4に弊社で「【Qiita Bash】エンジニアリングとデザインをつなぐAI活用」イベントが開催され、弊社デザイナーの HIGAshine が発表した以下の話をエンジニア サイドから補完してお話できればと思っています。

note.com

まとめ

  • 生成AI及び生成されたドキュメント(仕様書)を中心とした開発をやってみた
  • 生成AI にドキュメントのメンテナンスも一緒にさせることで (開発中は) 常に最新の仕様ドキュメント が作られる
  • 一つのファイルに集約せずにスコープ毎 (企画/フロント/バックエンド) に分けることで、 担当者ごとに見るべきものが明確になった

作ったものとその背景

ビザスクでは生成AI を業務・開発支援でもプロダクトでも活用しています。 プロダクトで使っている生成AI 用のプロンプトは現状ハードコードしていたり DB に保存していたり、実装チームによって運用方針は様々でした。 前者だとプロンプトの修正の度にエンジニアがコードを変更して PR → レビュー → リリース 作業が必要ですし、後者だと機能を作るたびにプロンプト編集のためのツール(画面)をセットで作る必要があり開発工数がかさみます。

なので今回、プロンプトをDBで管理しつつ、PdMが直接プロンプトを編集できて、様々なプロダクトから呼び出せる汎用的なプロンプト管理ツールを作りました。

ドキュメント駆動開発をやってみた

ドキュメント駆動開発

システム設計書というドキュメントを中心に据えて開発を行いました、これにはいくつかメリットがあります。

  1. 生成AI はセッションが長くなると勝手に情報を圧縮するので退避させる
  2. 人がドキュメントから情報を把握できるし、それを元にレビューもできる
  3. 実装段階で気づいた考慮漏れなどで修正した内容も commit 単位でドキュメントに反映して差分を把握しやすい
  4. 生成AIは面倒くさいと言わずに細かい部分までしっかりと書いてくれる
  5. 様々な生成AI ツールでドキュメントを通じて情報を共有できる

2 と 5 は特に大きく、システム設計書さえ作ればあとはそれを各生成AI になげることで開発を進めることができます。 実際に PdM は Gemini、エンジニアは Claude や Devin、 デザイナーは Claude Code to Figma 等を使ってそれぞれ作業を進められました。

プロジェクトメンバーは、バックエンドエンジニア(私)、フロントエンドエンジニア、スペシャリストエンジニア(設計レビュー)、デザイナー、 PdM の 5名で 3か月ほどの期間をかけて行われました。 (全員が複数のプロジェクト掛け持ちなので実際の作業工数的には 全員合わせてトータル 1人月ほどでした)

[第1話] 企画を、プロンプトで作った話

機能要件の検討 (spreadsheet上でPdMと)

生成AI を使ったのは主に以下の2か所です。

  1. 要求仕様書: このプロダクトがなぜ必要なのか、何を解決したのかを言語化し参加者で共通認識を持つ [by PdM]
  2. 機能設計書: 具体的にどういう機能を実装すればよいか [by バックエンドエンジニア]

1 と 2 の資料を共に、実際にプロンプトの変更作業を行う 他チームの PdM にヒアリングを行い初期リリースで必須なものに優先度を付けてスコープを確定させました。

[第2話] システム設計書を、プロンプトで作った話

シーケンス図

生成AI を使ったのは主に以下の1か所です。

  1. システム設計書: 各機能に対して具体的なシステム実装の定義 [by バックエンドエンジニア]
    • 画面構成
    • API エンドポイント
    • シーケンス図
    • ER図
    • (ドメイン) 用語集
    • API 詳細設計 (リクエスト、レスポンス、実行される SQL)
    • 非機能要件 (CSIRT レビュー用)

当たり前ですが一発で期待するものはできませんでしたので、作ったものを元に生成AI と壁打ちしながら検討を進めました。 API詳細設計で想定 SQL を出させるアプローチはよく機能してくれて、それを元に ER 図の見直し (フィールドや index) ができました。 セルフで壁打ちをして完成させた後に スペシャリストエンジニアやフロントエンドエンジニアにレビューしてもらいながらさらに精度を上げていきました。

[第3話] プロダクトコードを、プロンプトで作った話

実装したAPI (swagger)

生成AI を使ったのは主に以下の4か所です。

  1. API 実装: システム設計書を元に API単位でコード開発からPR作成まで実施 [by バックエンドエンジニア]
  2. ワイヤーフレーム作成: Figma 上で画面構成や遷移などのイメージを表示 [by デザイナー]
  3. モック: ワイヤーフレームを元に CSS 等を追加して開発環境で動作 [by デザイナー]
  4. 画面実装: システム設計書及びモックを元に作成 [by フロントエンドエンジニア]

システム設計書に全て列挙しているので、API 実装に関しては工数をかけずにさっくりと実装できました。 反省ポイントとしては以下の3点を挙げておきます。

  1. コーディング規約が 生成AI からは見えないところにあったせいで、それに沿わない記述が多く手直しの手間が増えてしまった (現在は改善済み)
  2. 細かい記法でセルフレビューが甘くなりやすく普段は指摘されないようなレビューコメントをもらうことが多かった
  3. さっくりできてしまう反面、メンバーのレビュー負担は増えてしまうのでアクセル全開にはできなかった

デザイナー部分に関しては本人が書いた記事に詳しく書いていますので是非ご覧ください!

note.com

参加したメンバーの感想

  • 大枠に関しては設計書があることで生成AI に実装を任せられた。一方で細かいコンポーネントの使い方などは冗長な記述になったりすることも多く手直しは一定数発生した。
  • 手戻りが発生することが無く、プロジェクトをスムーズに進められた。
  • ガッツリ生成AI を使うプロジェクトは初めてだったが、やりやすかった。

ビザスクではエンジニアの仲間を募集しています! 少しでもビザスク開発組織にご興味を持たれた方は、ぜひ一度カジュアルにお話ししましょう! recruit.visasq.co.jp