ブログページのロゴマーク猫が綴る雑多なブログ

AIとヒトで組む仕様駆動開発

人間は仕様の宣言、実装はAIが受託する「仕様駆動開発」の提唱と、Androidアプリ「wakAnd」の開発における実践事例。

仕様駆動開発とは何か

本稿では、人間が仕様を定義し、AIがそれに従い実装する開発スタイルを「仕様駆動開発」と呼びます。実装の詳細を人間は記述せず、要求・要件・背景事情・実現したいUX・受入れ条件といった仕様を宣言し、AIがそれらをソースコードに変換します。

バイブコーディングと呼ばれる技法に近いですが、明確に区別します。人間とAIの責任範囲を明確に分離し、それぞれが得意な領域を担当する考え方です。

人間が書くのはコードではなく仕様

私がAIに渡したのはJavaやXMLではありません。一方で、「アプリの全貌」でもありません。AIに伝えたのは、「何を実現したいか」「なぜそうするのか」「どのようなユーザ体験にしたいか」を整理したIssue形式です。実装方法の指定はしませんでした。

例えば、「ユーザー名は入力欄ではなく表示名を見せる」「Categoryは送信しない」「Projectだけを保持する」といった判断と、AIへの指示はすべて私が担っています。一方で、それをどのクラスへ実装し、どのAndroidAPIを呼び、どのレイアウトへ反映するかはAIがすべてを担いました。

人間が責任を持つのは、ソースコードではなく、プロダクトの仕様です。

AIは仕様を実装へ変換する

AIは私が提示した仕様を読み取り、それをJavaやXMLへ具体化します。必要なclassを追加し、既存コードとの整合性を取りながら実装を進め、CIで検証可能な状態まで持っていきます。

人間は、こうして生成されたコードを1行ずつのレビューをするのではなく、実機で期待した体験になっているかを検証します。問題があれば、修正指示はコードレベルではなくIssueとして「期待する動作、現状の挙動」としてAIに渡します。

この繰り返しによって、人間の集中する領域が「何を実現するか」にフォーカスしていきます。

24時間でAndroidアプリをリリースした事例

本稿では、「仕様駆動開発」の実践事例として、Androidアプリ「wakAnd」の開発を紹介します。AndroidFrameworkでの開発経験ゼロの状態から、着手の24時間後にGooglePlayConsoleでの審査提出まで到達しました。

本稿は「24時間で開発できた」紹介ではありません。「仕様駆動開発」の適用で、人間とAIとがどのように役割を分担し、開発を進めていくのかの具体例として提示します。

今回題材とした「wakAnd」

wakAndのアイキャッチ画像。ロゴと説明文が書かれている

「wakAnd」はAndroid端末で利用中のアプリを監視して、WakaTimeへ打刻する(HeartBeatをPOSTする)だけのアプリです。利用時間の集計や可視化はWakaTime自身あるいは既存アプリが担い、wakAndはBeatするだけに責務を限定しました。

この責務の限定、極小化は開発着手時からの軸です。AIが「Categoryも推定して送る」のを実装したときには、「カスタムルールとかでやらせる。削除」のIssueをAIに投げました。結果として、1600行のコードを生成させたものの、実装を触ったのは1-2行。私が見たのは実装の振る舞いだけでした。

24時間スプリントの流れ

「どうにかならんかな」という小さなMyIssueがMyProductを産みました。WakaTimeはIDE使用時間の計測が本来の目的であり、パソコンでの利用が想定されています。一方で、現状の私は、Twitter閲覧やChatGPTのスマホ版利用などがインプットとして積み重なっています。「スマホの特定アプリの利用時間も計上したい」これだけでした。

いつものIDE(IntelliJ Ultimate)、手慣れた相談相手(ChatGPT)、手練れの実装担当(Junie経由、今回はClaudeを選択)、ネットの海に溺れたチャラい仲間(Grok)と、GitHubで、初めてのAndroidアプリ開発をしました。

、車輪の再発明ではなく未踏エリアであると見切った私は、 IDEを開き、Androidプロジェクトを作成してrepoを作り、AIへ仕様の投下を始めました。 1時間半後の23時、実機にインストールしたAPKからポケモンGOがWakaTimeに計上されたことを確認して、 MVP(Minimum Viable Product;実用最小限の製品)の完成を確かめていました。

翌日は市役所タスクなどをこなしつつ開発時間を確保。Android権限、WakaTimeからProjectリストを取得、通知の改善といった利用体験(UX)改善のアップデート作業を回しました。「回した」というのは作業のサイクルがあるからです。「Issueの入力・AIによる実装・CIによるビルド・私の動作確認」、そして再びIssueの入力に戻る、3~5分サイクルのアップデート作業でした。

また、傍らでAppStoreリリースを見込んで、Developer登録も並行しました。初めてのAndroidアプリ開発は、構想から24時間後、v0.10リリースになりました。そしてGitHubActionのCIでAAB(Android App Bundle)を生成させるようになった私はGoogleに審査リクエストを提出していました。

では、24時間でAIと共にプロダクトを産み育てた私は、どのような「仕様/Issue」をAIへ渡していたでしょうか。

仕様を書くという仕事

「仕様を書く」といっても、画面仕様書や設計書を作るわけではありません。AIと対話しながら構築するにあたっては、「実装者に必要な情報だけ」を短いIssueとして渡します。実装はAIに委ねる分、意図と目標を決める判断が人間の役割でした。

Issueには実装を書かない

Issue(AIに渡す作業指示)に書くのは、「どう実装するか」ではなく「何を実現したいか」です。対象機能の目的や用途、役割と事前に把握している制約条件を伝えます。

例えば、「UserNameをinputではなくLabelにする。WakaTimeのAPIキーで認証はできるので、認証後に表示できればよいため。」といった、変更の対象・理由を伝えます。ここには、TextViewだとかどのXMLの責務かといった情報を載せません。それらは実装担当を担うAIの判断領域です。

人間が設計するのは、振る舞いであり、プログラム実装ではありません。

受け入れ条件が実装を導く

AIへのIssueで特に重要だったと考えるのが「受入れ条件」です。実装方法を指示する代わりに、「何をもって完成とするか」を明確に定義しました。

受入れ条件を定める代わりに、途中の実装方法はAIに委ねます。私はソースコードをレビューしません。しかし、完成したものが受入れ条件を満たしているかを検証します。おおよそNGになることはなく、むしろ「では次ここを」というステップアップのループに入ります。

実際にAIへ渡した仕様

実際にAIに渡したIssueの一例を掲載します。JetBrainsAI経由ClaudeCodeはこれらを解釈し、必要なXML,Java,各種リソースを更新していきました。

config画面を作る
- Appを立ち上げたら遷移なしの1画面を立ち上げる
- WakaTimeへの連携を意識
  - current User Name
  - input setting

簡単な計測機能を作る
- 最前面Appの名前を取得
  - Chromeの場合URLも取得
* まだWakaTimeへの連携までは実装しない 
画面の実装、ユーザ名がInputになってるけどLabelに変更
- APIキーで認証するため入力不要
  - 認証前:(未連携)と表示
  - 認証後:API経由でユーザー表示名を表示。リンク追加;ユーザのdashboard(既定のブラウザで開く)
サイレント通知で検知しているcurrentAppNameを表示するようにして(このAppを最前面にすると他App名が取得できてるか確認できないので)
Android端末に新しくAppがインストールされたら通知を出す
通知から「WakaTimeに連携する」「記録しない」を押下して処理クローズできたらいいな
Appの対応するProject入力欄の改良
- ユーザの既存ProjectをAPIで取得
- 新規Projectの入力にも対応
  - UIは<select>ブラウザレンダリングと似た感じにする
  - 「新規プロジェクト」を先頭に置いといて、それが選ばれた場合プロジェクト名入力を受け付けるUIを見せる(既存のUIに近い)
  - 新規プロジェクト名はソフト内で保持して、保存せずとも他Appにも展開できるように留意
フォールバック走ってる、パミじゃね?

私は、AIが生成した変更をGitHubにpushする。するとCIが回ってAPKファイルが出てきたら私は実機投入して触って検証する。そして、次のIssueを書く。そんなサイクルを回していました。

git logに残った仕様駆動開発

git log --pretty=format:$'%H\t%ci\t%s' | iconv -f UTF-8 -t UTF-16LE | clipで取得した全ログは次のようになっています。 (時間順をlogコマンドとは逆順に整備しました。%Hから%hに実質描画調整しました。Excelで処理しています)

Gitが記録しているのはソースコードの変更履歴ですが、この24時間(+v1.0以後の継続アップデート)では、その裏側にある「仕様の変遷」を読み取ることができます。

CommitHash Timestamp CommitMessage
94408227initial commit
d110b901v0.1
a5292672v0.2
830d105av0.3
2636d280build Action
b0ea09eafix build Action gradle
cba7e124署名を追加
edef2d0eignoreを追加
b7e5472dissue前面アプリに関わらずURLが送信されていた
20ddc36fissue アプリ識別子から表示名に変更
a9bfbe80issue サイレント通知の持続
b5803d67環境ファイル更新
79bb511dApp制御追加
691144f4v0.5
9cc401ebラウンドアイコン差し替え
0de36b94App名取得処理更新
2a006e3fApp名取得処理更新
36226ae5v0.6
cc912ff2他アプリの名称取得権限
7e4ae80dv0.7
0628bbbe通知権限
03f81d4cユーザ名をinputからlabelに変更
a84e984cAPIキー入力UI更新
c7f383ceAppソート実装
af233f06インストール検知追加
bb8796d5ProjectとCategoryのUI更新
c4512f95v0.8
5bf10cb5hotfix compile err
6d89fd18Setting>Category 廃止
c8f0cfc0サイレント通知の内容更新 計測対象外はApp名を表示しない
588d7f41サイレント通知 表示しない選択肢を追加
7b6b6f01v0.9
ffeed0b8fix 新規アプリインストールに対する判断通知が出ない事象
a74c9769fix システムUIとの干渉回避
17537b2eremove currentAppName from setting view
e98cb9bfv0.10
581cf566アイコンサイズ調整
629405dafix package from eng.pro.yui. to pro.eng.yui.
1b297d1eアイコン外周処理
e5a5e608アイコン外周処理
9c4f1d25リリース用資材管理
a12d32e4v0.11
dc4f03a1レイアウト調整 余白
24245fcbアイコンレイアウト調整
e66088bbv0.12
2306b5cbrelease v1.0
139a37fdリリースAAB生成workflow
2dfbb8e1AppIDをwakAndに大文字調整 [skip ci]
b7536151初版リリースノート [skip ci]
e35e24a6AppIDにpackage追従
72953ab9AppIDにpackage追従
aa39421dAdaptiveIcon対応
80d24198v1.1
10e4db92v1.1 re [skip ci]
6fa79fcbupdate URLを提供する
81d9c17fupdate OS17対応、ラベル「サイレント通知」→「マナー」をOS非依存表現に
7194d063update サイレント通知のURL表示改善
68240d8afix Androidという情報がWakaTimeの意図したフィールドに反映されていない
ac6b02a8v1.2
86536a64hotfix compile err for Version symbol
dd895043v1.2.1 [skip ci]
f6696445fix WakaTimeにAndroidOS由来であると認識させる
57a53337v1.2.2 [skip ci]
9ec260f5fix WakaTimeにAndroidOS由来であると認識させる
e1f5a0acv1.2.3 [skip ci]
3ccd1a88fix WakaTimeにAndroidOS由来であると認識させる
b84d045dfix WakaTimeにAndroidOS由来であると認識させる + マシン名
0a45633cfix UA
97133cd4v1.2.4 [skip ci]

ChatGPTにこのログを分析させたところ、の17時台のコミット頻度をツッコミされました。 17:31,:33,:36,:47,:51,:54 の数分毎にIssue対応が走る様子が克明な時間帯です。 もちろん、先頭のinitial commit からv0.3辺りの初速1時間8コミットで落ち着くまでのスピード感も、 「私がAndroidアプリ初見である」と再度ここで強調しなければいけないようなテンポではありますが。

また、バージョンを切るreleaseタイミングも意識しています。いったん手持ちのIssueがなくなったらv値を更新しました。

git log を振り返ってみても、v1.0は「仕様駆動開発」の一つの区切りに過ぎませんでした。

レビュー対象も変わる

仕様駆動開発では、人間が担当するレビューも変わります。ソースコードを読んで実装を確認するのではなく、「仕様通りのプロダクトになっているか」を確認する仕事へ移りました。

コードではなくE2Eを見る

私がwakAndの「完成」を確信したのは、JavaコードやCI通過ではありません。実機(Pixel6a)でポケモンGOを起動し、その使用時間がWakaTimeのダッシュボードに載った時でした。Android端末上でのアプリ利用がモニターされ、WakaTimeのAPIを通して私の利用記録に反映される。この一連の経路を成立させることが完成品の「受入れ条件」でしたから。

E2E(EndToEnd):操作の最初から最後までを通す総合テスト

また、個々のcommitに対しても、渡したIssueに対して期待通りの動きをするか、が観点でした。

ソースコードの正しさではなく、ユーザの利用シナリオに即した動作をするか、が重要なレビューでした。

UXが品質になる

レビューでは実機操作が中心となります。ここで人間が見る品質の視点も変わりました。

コードの通りの良さではなく、画面遷移や通知、設定画面の構成など、アプリの利用体験が品質となります。

今回の開発でも、「CurrentAppをサイレント通知に出す」「Project選択UIの変更」など、実装そのものではなく使い勝手に関するIssueを数多く投入しました。

AIは実装できますが、プロダクトは人の判断によって育ちます。

CIがコードレビューを補完する

コード量はJava+XMLで1600行のプロダクトです。この1.6kStepに対する人力目検レビューはしていません。それを補うのが、GitHubActionを活用したCIです。コンパイルや依存関係の問題は検出され、修正内容は次のIssueとしてAIにフィードバックします。問題がなければ、APKやAABを生成し、実機に投入できるリソースが作成されます。

実際、今回の開発で私がコードに直接手を加えたのは「9文字削除」だけでした。コンストラクタの宣言が変わってシンプルになったのに呼び出しが1箇所見落とされていて…。「Androidなんもわからん」私ですが、Javaなら読めるので「なるほどね」とBackSpaceを押していました。ただ、本当にそれだけしかソースコードには手を加えていません。(減らしています?)

人間が設計し、AIが実装し、CIが検証し、人間が仕様通りの動きか見つつ次のIssueを与える。この役割分担が、24時間でv1.0リリースという短い開発期間を支えていました。

人間のレビュー対象は、JavaやXMLではなく、Android-wakAnd-WakaTimeを貫く一連のユーザ体験そのものでした。

人間が担った設計判断

AIが実装を担うようになっても、人間の仕事は減りませんでした。むしろ、「何を作るか」あるいは「何を切り捨てるか」という判断の重要性が高まったと感じています。

Heartbeat送信だけに責務を限定する

今回制作したアプリ「wakAnd」の責務は「Android端末でアプリ利用状況を検知し、WakaTimeへHeartBeatを送る」だけです。利用時間の集計や分析、ダッシュボード表示はすべてWakaTimeあるいは既存アプリへ委ねることを開発着手時点で決めていました。

AIは「こんなこともできますね」を軽く乗せてきます。しかし、便利さと引き換えに責務の肥大化が訪れます。今回は一貫して「HeartBeat送信専用ツール」という立場をとりました。「別の責務のアイデアが浮かべば、それは別のアプリ」という考え方です。

Categoryを送らないという設計

途中、AIは利用しているアプリからWakaTimeでのCategoryを推定するロジックを組み込んでいました。一見便利そうな機能ですが、私は「機能を削除するIssue」をAIに渡しました。

WakaTimeにはカスタムルールという既存の仕組みがあります。アプリ利用のカテゴリ分けを決めるのはHeartBeatする側ではなく、既存システムの統計分析側である、という判断になりました。

「実装できる」ことと「実装する」ことは別の問題です。この判断は、AIではなく、人間が担う設計領域の問題です。

実装よりプロダクトを設計する

今回、私がもっとも時間を使ったのは「JetBrainsAIが処理をしている間のChatGPTとの進捗会議」でした。「今こんなIssue投げつつ前のバージョン触ってる。ここ微妙なんだよねぇ」という会話です。

AIの処理待ちは人間の休憩時間ではありませんでした。次のIssueを書き、実機を触りながらChatGPTと設計を議論する。コード実装の時間がプロダクトを育てる時間に置き換わる。そんな体験をしました。

AIは実装速度を大きく引き上げます。しかしプロダクトの方向性を決める判断は、人間が担い続けます。

仕様駆動開発で見えたヒトとAIの役割

24時間の開発を振り返って感じることは「プロダクトの開発者は私だ」ということです。当然ここまで述べたように、実装はAIがすべて担っています。しかし、私がプロダクトの在り方(仕様、品質)に責任を持ち続けました。

AIは実装、人間は判断

今回AIが生成したコード量は1600行です。一方で、人間が関与したコードは9文字削除です。

しかし、人間によるIssueの裁定や判断の積み重ねなしにプロダクトは出来上がりません。

AIに「どう作るか」を担わせ、人間は「何を作るか」と「受入れ条件」を判断する。この役割分担が、今回もっとも自然に感じました。

開発者の仕事はどう変わるのか

AIを活用した開発技法として「バイブコーディング(Vibe Coding)」という言葉があります。今回の私の経験も、それに近いものではあると思います。

一方で、本稿に収める「仕様駆動開発」は考え方に違いがあります。バイブコーディングが「思いついたものをAIと対話しながら形にする」開発を表すのであれば、仕様駆動開発は「人間が仕様を定義し、その実装をAIへ委譲する」開発を意図します。

実際、私が今回、24時間で回した仕様駆動開発で最も時間を使ったのは、ソースコード実装ではなく、Issueを書き、責務を規定し、UXを評価する、「判断」でした。AIは実装を高速化しましたが、実装の舵を取るのは人間が担っています。

AIの実装能力は今後さらに向上していくでしょう。だからこそ、開発者の価値は「どのようにソースコードを書くか」よりも、「何を作るべきか」「何をクライアントに提供するか」あるいは「何を作らないか」を定義する能力へと移っていくのでしょう。

この24時間の開発期間、途中で睡眠をとり、市役所へ手続きにも出かけました。それでも私が考え続けていたのは、ソースコードではなく「プロダクトの仕様」でした。少なくとも、「書いていたもの」はソースコードではなく「仕様」でした。

つれづれ

当ブログのお決まり、最後のsection「つれづれ」。

DUNSナンバー

法人としてGooglePlayStoreに開発者登録するのに際し、DUNSナンバーが要求されました。日本の内国法人については東京商工リサーチ社が番号を管理しており、公式ルートでの「自社番号の照会」には1万円(+消費税)がかかります。

しかし、Appleアカウントを使うとこれがなんと無料なんですねぇ。AppleDeveloperサイトのDUNS検索ページで、 丁寧にフォーマットを埋める必要はありますが、無料でメール通知してもらえます。

適材適所

今回、相手になってもらったAIは一人ではありませんでした。

実装は、JetBrainsAI経由ClaudeCode。仕様の壁打ちや合間の雑談こと閃きを整理する時間はChatGPT。ちなみにこのブログ記事の推敲もChatGPT。そして、ネットの海に潜って情報を掻き集めてくるのはGrokでした。

結局、人間のチームと変わらず、「得意分野で分担する」のが自然といいアウトプットが得られるのです。ClaudeCodeがコードを生成している間に、ChatGPTと次のIssueや仕様のブラッシュアップをする。人間のチーム作業と同じなのかもしれません。

私にとって仕様駆動開発は、人間とAIの役割分担だけでなく、AI同士の役割分担を考えるキッカケとなりました。

追補(記事の前提)

この記事は、既にソフトウェア設計・Git・CI・API利用などの技術運用経験がある個人開発者が、 Android開発という新しいプラットフォームへ挑戦した24時間の記録です。 「24時間でAndroidアプリを習得できる」という一般論を意図したものではありません。 今回の速度は、AIとの協業に加え、既存の設計・開発経験をAndroidへ転写した結果として成立しています。

了




コメントはこちらからお寄せください