メインコンテンツへ移動
制作記録2026.03.1810 minAI支援翻訳

AIで3万行書いたのに 何の言語かも知らなかった

Rockpile、Spottt、oddsの3本を経て振り返る、Vibe Codingの本当の落とし穴、検証ループ、公開までの7段階。

開放された複数の宇宙システムで隠れた依存関係を確認するチーム
目次
  1. 自分が何に乗っているか知らない
  2. 動く ≠ 使える ≠ 完成
  3. デザインは最も甘い罠
  4. 履歴を消して作り直す
  5. 同じ穴に2度落ちる
  6. AIは「ノー」と言わない
  7. おわりに
  8. 最後に——純粋なVibe Coderへの開発手順

根拠と限界

確信度 中改訂状態 再確認の指定なし

Vibe Codingはエンジニアリングをなくしたのではなく、最も不足する仕事をコード生成から検証と責任へ移した。

公開ソース

公開ソース

成立しない可能性

問題の主因は、AIによる開発手法よりも初心者の経験不足かもしれない。

モデルが進歩すればテストやセキュリティも自動化され、長期的なボトルネックにはならないかもしれない。

次の観測

プロセス導入前後の手戻り回数、セキュリティ上の問題、公開成功率、プロジェクトの存続期間。

前の記事では、AIで人生初のアプリを作った興奮を書いた。12800行、48時間、ノッチに住む小さなザリガニ。言外のメッセージは、壁は消えた、誰でも作れる、というものだった。

今回は、その記事の裏側だ。

Rockpileのあと、続けて2本作った。SpotttはSpotifyのアルバムカバーをASCIIアートにして、レトロな携帯ゲーム機風のデスクトップウィジェットに収める。oddsはメニューバーに常駐し、Polymarketの予測市場のオッズをリアルタイムで追う。3本、20日、3万行。記録したバグは60件を超えた。

コードも開発手順も「完成」の意味も知らないままの純粋なVibe Codingは、壁にぶつかる。

Vibe Codingはできる。ただ、おとぎ話ではない。これは最初の成功に舞い上がり、そのまま最後までvibeで進もうとする、私のような人に向けた落とし穴の一覧だ。末尾には7段階の開発手順を付けた。オープンソースのAIガイド用スキルvibe-shipにもしてあり、コードを知らなくても、問答形式でアイデアから公開まで進める。


自分が何に乗っているか知らない

Spottt開発2日目。AIと何十往復も話し、十数個のバグを直し、9案の外装デザインを作った。アプリもデスクトップウィジェットも動いた。

そこで、ひとつ質問した。

技術者たちが、開放された機体の複雑で未整理な内部システムを調べている
コンセプトシーン

コンセプトイメージ|システム境界が分からないままの変更は、リスクを広げる

「このアプリ、Pythonで作っているの?」

そう。自分のアプリの言語を知るまで2日かかった。

答えを聞いた瞬間、変更すると言った。

Python + PyWebViewはmacOSのウィンドウ管理がひどかった。他のアプリを隠し続け、全画面も本当の全画面ではなく、配布物は45MB。Dockのロケットアイコンも、まともなアプリに見えなかった。十数件直したが、1つ直すと2つ出てきた。

Tauri(Rust + WebView)に移ると、容量は45MBから5.3MBへ減り、ウィンドウ管理の問題も大半が消えた。ただし、それまでPyWebViewの調整に使った時間は全部無駄になった。

AIは、遠回りしていると自分から教えてくれない。実行役であって相談役ではない。「やって」と言えばやる。聞かなければ言わない。


動く ≠ 使える ≠ 完成

この3段階の距離は、想像よりずっと長かった。

動く

コンパイルが通り、アプリが起動し、画面で何か動く。「だいたいできた」と思う。まだまだだ。

Spotttのターミナル版が初めて動いたとき、5分ほど喜んだ。その後、ロゴの文字が画面を下へ流れ続け、止まらなくなった。AIがalternate screen bufferを使い忘れたからだ。ターミナルUIの基本なのに。皮肉にも、AIに言われてcloneした参考プロジェクトでは使われていた。自分で書くときは参考にしなかった。

oddsにはもっと妙な問題があった。AIがIBM Plex Monoのフォントファイルを「生成」して入れた。コンパイルも起動もできたが、字間も太さもおかしい。長く調べた末、本物のフォントではなく偽のバイナリデータだとわかった。AIがTTFを捏造し、読み込みに失敗したシステムが黙って標準フォントへfallbackしていた。

AIはコードを書けるが、バイナリファイルを「生成」はできない。フォント、画像、音声は本物が必要だ。

使える

アプリが動き、機能があり、操作にも応じる。これで完成か。

違う。

oddsでは長く悩んだバグがある。「フォロー」を押しても何も起きない。エラーも通知もなく、ボタンも一覧も変わらない。沈黙だ。

原因は、データを配列と集合の2か所に保存し、初期化では配列だけ埋めたことだった。「フォロー済み」の判定は空の集合を読み、「+ フォロー」と表示する。クリック後の追加処理は配列を読み、すでに存在するからreturnする。両方とも単独では正しいが、一緒になると何も起きない。

無言の失敗は最も怖いバグだ。ユーザーには壊れて見えるのに、ログはきれいで、AIに何を貼ればいいかさえわからない。

完成

コードが書けたら完成だと思ったのが、いちばん深い落とし穴だった。

macOSアプリを配布するには、Code Signing、AppleのNotarization、DMG化、Hardened Runtime、Stapleによるチケット埋め込みが必要になる。どれも作る前は聞いたことすらなかった。

さらに基本的な問題もある。`.app`はshellの環境変数を引き継がないため、ターミナルで設定したAPI keyをアプリ化すると読めなくなるのだ。SpotttのPython版で一度踏み、Tauriに移ってもう一度踏んだ。同じバグを違う技術構成で2回踏んだことになる。

Rockpileはさらにちぐはぐだった。Day 2にAppleの公証を通したが、振り返ればまったく不要だった。まだユーザーが1人もいないのに、誰に公証を見せるというのか。

oddsのバージョン番号は5ファイルに分かれ、5つとも食い違っていた。CHANGELOGはv0.2.1、READMEはv0.1.0、設定画面はv0.2.2、案内画面はv0.1.2で、Git tagはゼロ。「最新版は何」と聞かれても、自分ですら答えられなかった。

コードが動くようになった時点では、まだ道半ばにすぎない。


デザインは最も甘い罠

3つのプロジェクトでデザインに費やした無駄な時間は、開発時間全体の3分の1を超えるかもしれない。

SpotttではWalkman、Tamagotchi、Discman、Teenage Engineeringなど9案の外装を作った。方向性を変えるたびに前の作業が無駄になり、9案から選んだデザインも実装中にまったく別物になった。

oddsはさらに多い。11方向のHTMLプレビュー、ロゴ探索3回、shader風アイコン、方向性の投票ページまで作り、HTML案は計21本に上ったが、大半は使わなかった。

何がいけなかったのか。「もう1方向」と言えばすぐ出る。「レトロも試して」と言えばすぐ出る。止めてくれる人がいないのだ。

Rockpileのスプライトも同じだった。ピクセル、フラット、3D、手描き、ベクターの5種類を試し、それぞれAIに30組すべて作らせた。結局Pixar 3Dを選び、残り4系統の120枚はすべて捨てた。

最初に各スタイル1、2枚の見本で方向性を確認していれば、デザイン時間の80%は省けたはずだ。


履歴を消して作り直す

開発中、最も冷や汗をかいた日だった。

Rockpileのコードを全面レビューしたところ、テストスクリプトに本物のGateway Tokenが直書きされていた。公開リポジトリのソースコードなので、誰でも見て私のサーバーに接続できてしまう。調整を楽にするために既定値を入れたまま、GitHubへpushする前の確認を忘れていたのだ。コードを生成したAIも「このtokenはソースに入れるべきではない」とは教えてくれなかった。

損傷した軌道施設を解体しながら、チームが重要構造をその場で組み直している
コンセプトシーン

コンセプトイメージ|作り直すだけでは、設計理解とセキュリティ確認の代わりにならない

修正はコードを書くより10倍難しかった。現在のファイルを直すだけでは済まない。Gitには履歴が残るため、該当行を消しても過去のcommitから辿れてしまう。`git-filter-repo`でGit履歴全体から痕跡を消し、force pushでリモート側を上書きして、リポジトリの履歴を丸ごと書き換えた。

同じレビューで、ほかの問題も次々と見つかった。TCP Socketがすべてのネットワークインターフェースを待ち受けており、同じWiFi上の機器なら偽イベントを送信できる状態だった。JSONはシリアライズ用ライブラリを使わず文字列連結で組み立てていたため注入の脆弱性があり、API KeyもKeychainではなくUserDefaultsの平文plistに保存されていた。さらにHTTP本文の容量制限がなく、DoS攻撃が可能な状態だった。

プロなら常識でも、純粋なVibe Coderは危険の存在すら知らない。AIが書いたコードに穴があっても、まったく見抜けないのだ。

oddsでは少し学び、push前に鍵や個人メール、ローカルのパスが含まれていないかAIに安全性の確認を頼んだ。だが、これも失敗して初めて身についたことだ。

覚えておいてほしい。GitHubへpushする前は毎回、公開してはいけない情報が含まれていないかAIに点検させること。すでにpushしてしまった場合は、ファイルを消すだけでは不十分だ。Gitは履歴を保持するため、履歴ごと消去する必要がある。


同じ穴に2度落ちる

Spotttをインストール用にパッケージ化すると、起動してすぐ落ちた。開発環境では読めていた設定が、パッケージ化後に読めなくなったのだ。修正後に技術構成を変えると、また同じ問題が起きた。

AIには記憶がない。新しい会話、新しい文脈になれば、毎回リセットされる。人間側が覚えていて先に伝えなければ、また同じ穴を踏ませてしまう。

Rockpileでも似たことが起きた。体力が尽きて腹を見せる状態になると、AIの作業が再開しても永遠に復帰しない。回復処理を入れ忘れていたからだ。プロジェクト名を変更した際も、古い名前が何か所か残ってしまい、名前が食い違って接続できなくなった。「改名したのに参照を変え忘れる」といったミスは、コードを知らない人間には予見できない。

そこで、つまずきの記録をつけるようにした。問題ごとに1行書き留め、次のプロジェクトでAIに見せるのだ。


AIは「ノー」と言わない

3本を振り返ると、最も時間を浪費したのはバグではなく、本来作るべきではなかった機能だ。

すべてを3言語対応にし、oddsにはスクロールする相場表示とターミナル風の起動演出を入れ、RockpileにはAI提供元5社の同時対応を組み込んだ。作っている最中はどれも「あるとよさそう」に見えた。しかしあとで見返すと、日本語ユーザーはいないし、相場表示はメインの一覧と重複しており、提供元の大半は不要で、起動演出に至っては1度見るだけなのにスキップ機能すらなかった。

なぜ作ったか。AIが物わかりよすぎるからだ。「日本語も」と言えば加え、「起動演出を」と言えば作る。本当に必要かとは聞かない。

思いつきは、AIなら数分で作れるから無料に見える。でも保守は無料ではない。3言語なら文言修正が3回、5社対応なら新機能の適応が5回必要だ。

oddsのチームレビューで、仮想CEOが言った言葉を覚えている。

"有三种语言但在那些市场没有分发渠道,也没有需求证据。这是伪装成完整性的 scope creep。"

その後、機能を足す前に自問する習慣ができた。これがなくても製品は使えるか。使えるなら、まず作らない。


おわりに

前の記事は、アイデアと製品の間にあった壁はもうない、と締めた。

今もそう思う。ただし、注釈がいる。

壁は消えたが、地面には穴がある。開発手順を知らなければ技術選びに何日も無駄にする。コードの違いを知らなければ自分のアプリの言語すらわからない。「完成」を知らなければ、動いたあとに署名、パッケージ化、公開の最後の区間で止まる。安全確認をしなければAPI keyがGitHubで公開される。

コードを学べという話ではない。私もいまだに1行も書けない。でも、何で作られているか、動くことと公開できることの距離、push前に何を調べるか、どの機能を作り、切るかは知る必要がある。

これはプログラミング知識ではなく、製品づくりの常識だ。

Vibe Codingで必要な知識は、コードの書き方から製品の作り方へ変わった。かつては技術力、今は判断力が壁になる。これは進歩だ。

ただ、AIを開いて数言話せば公開まで行けると思うなら、この記事の穴をすべて自分で踏むことになる。


最後に——純粋なVibe Coderへの開発手順

失敗を経て、自分用の手順をまとめた。難しい方法論ではなく、何を先に、何を次にやるかだ。最初からこの順序なら、半分ほどの時間を省けたと思う。

大規模な工程ラインが、確認、構築、試験、引き渡しの連続した区画に分かれている
コンセプトシーン

コンセプトイメージ|安定した提供は一回の生成ではなく、段階的な検証から生まれる

第1段階——話しかける前に考える

AIを開いてすぐ「XXXを作って」と言わない。10分で3つ考える。誰が使うか。核になる機能は何か、1つだけ。見た中で最も近い製品は何か。答えを書いてから始める。

第2段階——技術構成を聞く

作りたいものを伝え、「最適な技術方式は何、なぜ、ほかの選択肢と長所短所は」と聞く。理解できる言葉で説明してもらい、わからなければ聞き直す。10分で何日も節約できる。

第3段階——最小版をまず動かす

核の機能だけ作る。デザイン、多言語、演出、あるとよさそうなものは作らない。最も不格好でも核が使える版が目標だ。動いたらスクリーンショットを残す。それがv0.1。動作後はAIにコードレビューを頼み、隠れた問題を調べるとよい。

第4段階——公開する、安全性の確認も含めて

飛ばして最終日に困る人が多い。まずAIに鍵、パスワード、個人メール、ローカルのパスなど、公開すべきでない情報がないか確認させる。通ったら「人に配布するには何が必要」と聞き、全手順を並べて一度試す。早く通れば、あとで慌てない。

第5段階——ここでデザイン

核が安定し、公開手順が通り、安全確認にも合格した。そこで初めてデザインする。好きな参考画像を2、3枚渡し、方向を決める。案は3つまで。1つ選んで進める。

第6段階——機能追加の前に自問する

追加したくなったら「なくても製品は使えるか」と聞く。使えるなら「あとで」の一覧へ。核の体験を磨いてから見直し、1回に最大3つ選ぶ。

第7段階——すべて記録する

問題があれば書き留める。詳細でなく、「パッケージ化後に設定が読めない」の1文でよい。次のプロジェクトでAIに貼る。自分では覚えないが、こちらが代わりに覚えられる。

7段階のどれにも、コードを書く能力はいらない。でもこの順で進めれば、私の落とし穴の大半を避けられる。

この流れはオープンソースのAI開発ガイド用スキルvibe-shipにまとめた。対話形式で全手順を案内するもので、誰でもインストールして使える。

Rockpile: github.com/ar-gen-tin/rockpile

Spottt: github.com/ar-gen-tin/spottt

odds: github.com/ar-gen-tin/odds


Don't Panic. Accelerate.

Guideで次へ進む

OpenAI Codex

AIコーディングエージェントにプロジェクトを読ませ、説明と小さな変更を任せます。

次の行動を開く →