
Docker Sandboxes + Claudeで、音声アイデアからADRを切ってUI実装まで進めてみた
雑に作るためのDocker Sandboxesという箱庭

今日は、AIまわりの開発フローがかなりきれいにつながった日だった。
思いついたアイデアを雑にささっとしあげたい。その1番のネックが、開発中に何度も効かれる「承認」作業。時間のロス。
その負担を減らすために、雑に作っても「危険」ではない安全な作業環境を構築して、オートパイロットで一気にしあげる。という開発フロー。
ざっくり言うと、macOSにDocker Sandboxesを入れて開発の土台を作り、Claude Codeをサンドボックス内で動かし、バーっとしゃべって入力した事業アイデアをADRに落とし、そのままClaude DesignでUI実装までつなげた、という流れ。
単に「AIにコードを書かせた」という感じではなくて、アイデアの入力から設計判断の明文化、UIへの具体化までを一本の流れで進められたのがよかった。
今日の流れ
1. まずはDocker SandboxesをmacOSに入れて、開発の足場を作った
最初にやったのは、ローカルの開発を安心して回すための足場づくり。
AIと一緒に試行錯誤していると、依存関係や実験用のプロセスがすぐ増える。そうなると、あとから「この変更どこまで安全だっけ」「ローカルをどこまで汚したっけ」が分かりにくくなる。
そこで最初にSandbox環境を用意して、ある程度隔離された前提で動かせる状態を作った。やっぱり、設計や実装の速度を上げるには、先に「安心して壊せる場所」を作っておくのが大事だと思う。
導入自体はかなりシンプルで、macOSならHomebrewで入れられる。
brew install docker/tap/sbx
sbx loginプロジェクトディレクトリに入ったら、そのままClaude Codeをサンドボックス内で起動できる。
cd ~/my-project
sbx run claude基本の運用コマンドも分かりやすくて、起動確認、停止、削除まで一通りそろっている。
sbx ls
sbx stop my-sandbox
sbx rm my-sandbox2. Docker Sandboxesでは、Claudeのbypass permissionsがデフォルトで有効だった
今回のポイントは、Claude側で何かを手動設定したことではなく、Docker SandboxesのClaude Code用テンプレートが `--dangerously-skip-permissions` で起動する前提になっていたこと。
つまり、bypass permissionsを自分でonにしたというより、サンドボックスで隔離された環境だからこそ、そのモード前提で速度重視に進められた、という理解のほうが正確だった。
この前提のよかったところは、細かい確認のたびに流れが止まりにくいこと。今回みたいに、構想整理から文書生成、UI設計までを短時間でつなぐなら、1回ごとの停止コストはかなり大きい。
もちろん何でも自動化すればいいわけではないけれど、少なくとも「今は探索フェーズで、まず速度を優先したい」という局面ではかなり相性がよかった。
たとえば、プロジェクト配下でそのまま立ち上げるなら次の形で足りる。
sbx run claude起動時に最初の指示もまとめて渡せる。
sbx run claude -- "Add error handling to the login function"音声入力した事業アイデアを、設計ドキュメントに変換した
今回いちばん手応えがあったのはここ。
事業アイデアって、最初からきれいな文章では出てこない。むしろ頭の中にあるのは、断片的な問題意識とか、「こういう体験がほしい」という感覚に近い。
そこで、まずは音声で事業アイデアを吐き出した。テーマは、個人の業務効率化を支援する「自分専用エージェント」構想。タスクの自動分解、RAGによる過去知識の活用、そして単なる効率化だけではなく、モチベーション設計まで含めたプロダクトのイメージ。
音声から出てきたラフな内容をもとに、まず構想の要約を作って、そのあと事業構想とシステム設計の文書に整理した。この順番がよかった。
いきなり詳細設計に入るんじゃなくて、先に「何を作ろうとしているのか」を言葉にしておくと、その後の判断がかなりぶれにくくなる。
そのままADRを作った
今回、特によかったのは「アイデアを整理して終わり」ではなく、そのままADRまで切ったことだった。
ADRは、あとから見返したときに「なぜその技術選定にしたのか」を説明できるのが強い。今回はフロントエンド技術戦略として、HTMXとReactのハイブリッドアプローチを採択する判断をまとめた。
これがよかったのは、単に技術比較表を作るよりも、意思決定を時間軸で扱えたこと。
たとえば今回の判断は、
Phase 1のMVPはHTMX中心で速く作る
Phase 2からReactを追加して複雑なUIに対応する
将来的なモバイル展開も見据える
という流れになっている。
つまり、「どちらが優れているか」ではなく、「今の制約の中で何を先に取るか」を明文化できた。AIを使うと案がいくらでも出てくるからこそ、こういう意思決定ログの価値はむしろ上がっている気がする。
設計の次に、Claude DesignでUI実装へ進んだ
ADRまで作ったあと、今度はClaude Designに設計意図を渡してUI実装に進めている。

ここで面白いのは、単なる「いい感じの画面を作って」ではなくて、プロダクトの世界観や体験の方向性まで含めて渡せること。
今回のテーマは、仕事をただ処理するツールではなく、「退屈な義務を冒険に変えるUI」にすること。具体的には、
音声・テキスト・PDFを起点にした入力
タスクの自動分解
実行中の進捗表示
完了タスクの物語化
モチベーションを見える化するダッシュボード
といった要素をデザインに落としている。
この流れのいいところは、要件定義とUIの距離が短いことだと思う。事業アイデア、システム設計、ADR、UIプロンプトが分断されず、同じ文脈の延長線上にある。だから、画面の見た目だけが先行しにくい。
今日の進め方で良かったこと
1. 音声入力が、思考の初速を上げた
キーボードで最初から整った文章を書こうとすると、思考より先に編集が始まってしまう。音声入力だと、曖昧な段階でもアイデアを出しやすい。
特に事業アイデアみたいに、構造化される前の発想を扱うときは、音声のほうが相性がいいと感じた。
2. ADRが、AI時代の設計ログとして機能した
AIに相談すると、すぐに複数案が出る。だからこそ、「最終的に何を選び、なぜ選んだのか」を人間側で残しておく必要がある。
ADRはこの役割にかなり向いている。あとから実装方針がぶれたときも、議論の出発点に戻りやすい。
3. UI実装に入る時点で、前提がかなり揃っていた
いきなりデザインから入ると、見た目はできても思想が弱くなりやすい。今回は、構想要約、システム設計、技術ADRが先に揃っていたので、UIの指示もかなり具体的にできた。
この順番は、たぶん再現性が高い。
今ある成果物
現時点で、こんなドキュメントが揃っている。
音声アイデアを整理した構想サマリー
事業構想とシステム設計書
フロントエンド技術選定のADR
Claude Designに渡すUI/UXプロンプト
この4点があるだけで、「思いつき」だったものがかなりプロダクトらしくなる。
まとめ
今日は、Docker Sandboxesで開発の足場を作り、隔離された環境の中でClaude Codeを速度重視で回し、音声入力した事業アイデアを設計ドキュメントとADRに変え、そのままClaude DesignでUI実装へ進めた。
やってみて感じたのは、AI活用で本当に効くのは単発のコード生成よりも、アイデアから設計、意思決定、UI具体化までの接続を滑らかにすることだという点。
特に、音声入力 → 構想整理 → ADR → UI実装、という一本の流れはかなり強い。思考を止めずに前へ進められるし、あとから見返しても「なぜこの形になったのか」が追える。
しばらくはこのやり方で、自分専用エージェントの実装をもう少し前に進めてみたい。