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」は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 |
|---|---|---|
94408227 | initial commit | |
d110b901 | v0.1 | |
a5292672 | v0.2 | |
830d105a | v0.3 | |
2636d280 | build Action | |
b0ea09ea | fix build Action gradle | |
cba7e124 | 署名を追加 | |
edef2d0e | ignoreを追加 | |
b7e5472d | issue前面アプリに関わらずURLが送信されていた | |
20ddc36f | issue アプリ識別子から表示名に変更 | |
a9bfbe80 | issue サイレント通知の持続 | |
b5803d67 | 環境ファイル更新 | |
79bb511d | App制御追加 | |
691144f4 | v0.5 | |
9cc401eb | ラウンドアイコン差し替え | |
0de36b94 | App名取得処理更新 | |
2a006e3f | App名取得処理更新 | |
36226ae5 | v0.6 | |
cc912ff2 | 他アプリの名称取得権限 | |
7e4ae80d | v0.7 | |
0628bbbe | 通知権限 | |
03f81d4c | ユーザ名をinputからlabelに変更 | |
a84e984c | APIキー入力UI更新 | |
c7f383ce | Appソート実装 | |
af233f06 | インストール検知追加 | |
bb8796d5 | ProjectとCategoryのUI更新 | |
c4512f95 | v0.8 | |
5bf10cb5 | hotfix compile err | |
6d89fd18 | Setting>Category 廃止 | |
c8f0cfc0 | サイレント通知の内容更新 計測対象外はApp名を表示しない | |
588d7f41 | サイレント通知 表示しない選択肢を追加 | |
7b6b6f01 | v0.9 | |
ffeed0b8 | fix 新規アプリインストールに対する判断通知が出ない事象 | |
a74c9769 | fix システムUIとの干渉回避 | |
17537b2e | remove currentAppName from setting view | |
e98cb9bf | v0.10 | |
581cf566 | アイコンサイズ調整 | |
629405da | fix package from eng.pro.yui. to pro.eng.yui. | |
1b297d1e | アイコン外周処理 | |
e5a5e608 | アイコン外周処理 | |
9c4f1d25 | リリース用資材管理 | |
a12d32e4 | v0.11 | |
dc4f03a1 | レイアウト調整 余白 | |
24245fcb | アイコンレイアウト調整 | |
e66088bb | v0.12 | |
2306b5cb | release v1.0 | |
139a37fd | リリースAAB生成workflow | |
2dfbb8e1 | AppIDをwakAndに大文字調整 [skip ci] | |
b7536151 | 初版リリースノート [skip ci] | |
e35e24a6 | AppIDにpackage追従 | |
72953ab9 | AppIDにpackage追従 | |
aa39421d | AdaptiveIcon対応 | |
80d24198 | v1.1 | |
10e4db92 | v1.1 re [skip ci] | |
6fa79fcb | update URLを提供する | |
81d9c17f | update OS17対応、ラベル「サイレント通知」→「マナー」をOS非依存表現に | |
7194d063 | update サイレント通知のURL表示改善 | |
68240d8a | fix Androidという情報がWakaTimeの意図したフィールドに反映されていない | |
ac6b02a8 | v1.2 | |
86536a64 | hotfix compile err for Version symbol | |
dd895043 | v1.2.1 [skip ci] | |
f6696445 | fix WakaTimeにAndroidOS由来であると認識させる | |
57a53337 | v1.2.2 [skip ci] | |
9ec260f5 | fix WakaTimeにAndroidOS由来であると認識させる | |
e1f5a0ac | v1.2.3 [skip ci] | |
3ccd1a88 | fix WakaTimeにAndroidOS由来であると認識させる | |
b84d045d | fix WakaTimeにAndroidOS由来であると認識させる + マシン名 | |
0a45633c | fix UA | |
97133cd4 | v1.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へ転写した結果として成立しています。了
猫が綴る雑多なブログ