1. ざっくり作る
最初から完璧を目指さない。まず動くものを出す。
TokiQRの開発では、初日の最初のコミットから75分以内にCDN依存を全排除し、システムフォントに移行した。翌日にはOpusからCodec2への音声エンコーディング変更、i18n対応、サービスワーカー、リブランドまで完了している。どれも最初から完成形ではない。ざっくり動くものを出し、そこから磨いていく。
AIとの協業で重要なのは、最初の指示に全情報を詰め込まないことだ。「こういうものが欲しい」という輪郭を伝え、動くものが出たら触ってみる。触ってからわかることが、机上の仕様書より圧倒的に多い。
完璧な設計書を書く時間で、3回作り直せる。
2. データフローから辿る
コードが複雑になったとき、読むべきはロジックではない。データの流れだ。
ユーザーの入力がどこに渡り、どう変換され、どこに保存され、どう表示されるか。この流れを辿れば、バグの原因もアーキテクチャの改善点も見えてくる。TokiQRでは、音声データが録音→Codec2エンコード→Base64URL→QRコード→URL→デコード→再生という一本のパイプラインで流れる。このデータフローが明確だからこそ、どこに手を入れるべきかが瞬時にわかる。
AIに修正を依頼するときも、「この関数を直して」ではなく「このデータがここからここに流れる過程で、ここがおかしい」と伝える。データフローで語れば、AIは的確にコードを書ける。
3. 設計思想と照らす
動くコードができたら、次に問うのは「これは設計思想と合っているか」だ。
TokiStorageの設計思想は明確だ。外部依存を増やさない。サーバーを持たない。ローカルファーストで動く。1000年残る前提で作る。この基準があるから、Opusが使えないとわかったとき迷わずCodec2に切り替えられた。Safari印刷対応に膨大な時間を費やした末に「Chrome限定」と決断できた。FFmpegの動画機能を2時間で構築し、WASMメモリ問題が出た瞬間に全削除できた。
設計思想がなければ、すべての判断が「動くかどうか」に還元される。動くけれど思想に合わないコードは、後で必ず負債になる。
「動く」は最低条件。「思想に合う」が合格条件だ。
4. 容赦なく哲学に寄せる
設計思想との照合をさらに深めると、哲学になる。
なぜ外部依存を排除するのか——永続性のためだ。なぜサーバーを持たないのか——バーンレートゼロで持続するためだ。なぜオープンソースにするのか——隠す理由がないからだ。技術的な選択の背後にある「なぜ」を突き詰めると、必ず哲学に到達する。
哲学に寄せるとは、技術的な妥協を哲学で正当化することではない。むしろ逆だ。哲学と矛盾する技術的選択に気づいたとき、容赦なく技術の方を変えるということだ。特許出願を弁理士のお墨付き付きで辞退したのは、「公開主義」という哲学との矛盾に気づいたからだ。
AIは哲学を持たない。だからこそ、哲学は人間が持つ必要がある。AIに「外部依存なしで実装して」と伝えるとき、その背後にある哲学の厚みが、出力の質を決定する。
5. 捨てることを戸惑わない
765コミットの中には、数十コミット分の労力を費やした末に全削除した機能がいくつもある。
Safari印刷対応。動画機能（FFmpeg + TokiVideoバイナリフォーマット）。特許出願。どれも相当な時間と労力を投じたが、設計思想と合わないとわかった瞬間に切った。「もったいない」という感情が判断を鈍らせる。沈没費用の罠だ。
バイブコーディングでは、AIが高速にコードを生成するからこそ、捨てるコストが劇的に下がっている。手で書いた100行を捨てるのは痛いが、AIが生成した1000行を捨てるのは痛くない。この非対称性を意識的に活用すべきだ。作っては壊し、作っては壊すサイクルの速さが、バイブコーディングの真の強みだ。
捨てた量が、プロダクトの純度を決める。
6. 思想を残す
コードは変わる。フレームワークは廃れる。APIは消える。だが、なぜそう作ったかという思想は残る。
TokiStorageでは130本以上のエッセイを書いた。技術選定の理由、捨てた機能の記録、設計判断の意図、哲学の言語化。これらは「ドキュメント」ではない。思想のアーカイブだ。
バイブコーディングでAIと協業するとき、プロンプトに込めた意図はセッションが終われば消える。しかしエッセイとして言語化しておけば、次のセッションで、次のプロジェクトで、あるいは次の世代で、同じ思想を再現できる。
コードを書くことがAIに委譲されていく時代に、人間に残る固有の仕事は「なぜ」を定義し、言語化し、残すことだ。バイブコーディングの最終成果物はコードではない。思想だ。
ざっくり作り、データフローで辿り、設計思想と照らし、
哲学に寄せ、捨てることを戸惑わず、思想を残す。
バイブコーディングの精度は、思想の解像度で決まる。
バイブコーディングの概念については「バイブコーディング」で、高速開発の方法論については「ラピッドプロトタイピング」で、開発の実録については「13日間の開発記録」で詳しく論じている。