https://www.m1ke.org/tags/dev/Recent content in Dev on M1KE BL0GHugo -- gohugo.ioja-jpmikeTue, 14 Jul 2026 22:20:42 +0900https://www.m1ke.org/p/ai%E9%A7%86%E5%8B%95%E9%96%8B%E7%99%BA%E3%81%AE%E6%96%B9%E6%B3%95/Tue, 14 Jul 2026 22:20:42 +0900https://www.m1ke.org/p/ai%E9%A7%86%E5%8B%95%E9%96%8B%E7%99%BA%E3%81%AE%E6%96%B9%E6%B3%95/<img src="https://www.m1ke.org/p/ai%E9%A7%86%E5%8B%95%E9%96%8B%E7%99%BA%E3%81%AE%E6%96%B9%E6%B3%95/claude.png" alt="Featured image of post AI駆動開発の方法" /><h2 id="背景">背景</h2> <ul> <li>最近めっきり自分の手でコードを書かなくなった</li> <li>AIに書いてもらったほうが速くて正確だから</li> <li>でもAIで書いてもらっても課題はやっぱりある</li> <li>そこでその解決策を考えた</li> </ul> <h2 id="ai駆動開発の課題">AI駆動開発の課題</h2> <ul> <li>AI駆動で開発する一番の問題は変更がシーソー化する件</li> <li>AI駆動でコードを書くと機能を追加するのが速いし、レビューが追いつかない</li> <li>そのため、AIを信じて機能をガンガン追加してもらう</li> <li>そうすると気が付かないうちにエンバグやデグレを起こしている事が多い</li> <li>Aを解決するためにBを足した結果、CとDの問題が新たに発生したみたいな現象</li> <li>それをさらにアドホックに直すと課題が発散して、まるでハウルの動く城のようになってしまう</li> <li>特に安い簡便な解決策ほど副作用があったりする（例えば正規表現で安易に回避など）</li> </ul> <h2 id="解決策はhypothesis-driven-development">解決策はHypothesis-Driven Development</h2> <ul> <li>そのシーソーの解決策は、Hypothesis-Driven Development</li> <li>Hypothesis-Driven Developmentは課題解決に飛びつかない実装方法</li> <li>以下HDDと略す</li> </ul> <h2 id="hdd">HDD</h2> <ul> <li>HDDでは以下のワークフローを通す</li> <li>6段階のフローを通して課題の発見と解決をする</li> </ul> <div class="highlight"><div class="chroma"> <table class="lntable"><tr><td class="lntd"> <pre tabindex="0" class="chroma"><code><span class="lnt"> 1 </span><span class="lnt"> 2 </span><span class="lnt"> 3 </span><span class="lnt"> 4 </span><span class="lnt"> 5 </span><span class="lnt"> 6 </span><span class="lnt"> 7 </span><span class="lnt"> 8 </span><span class="lnt"> 9 </span><span class="lnt">10 </span><span class="lnt">11 </span><span class="lnt">12 </span></code></pre></td> <td class="lntd"> <pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"><span class="line"><span class="cl">runs </span></span><span class="line"><span class="cl"> ↓ 観測事実・証拠を保存 </span></span><span class="line"><span class="cl">issues </span></span><span class="line"><span class="cl"> ↓ 再現可能な課題と根因調査、仮説を作る </span></span><span class="line"><span class="cl">eval </span></span><span class="line"><span class="cl"> ↓ A/B検証して採用案のメリデメを明らかにする </span></span><span class="line"><span class="cl">src </span></span><span class="line"><span class="cl"> ↓ 検証済みの変更だけ昇格 </span></span><span class="line"><span class="cl">tests </span></span><span class="line"><span class="cl"> ↓ 解決した課題を再発不能にする回帰テストを残す </span></span><span class="line"><span class="cl">docs </span></span><span class="line"><span class="cl"> ↓ 判断理由と棄却案と知見を記録する </span></span></code></pre></td></tr></table> </div> </div><p>それぞれの意味は以下になる:</p> <ul> <li>runs: 動かした時に出たすべての実行ログ、実行日時ごとにフォルダ分けされる</li> <li>issues: 課題をフォルダにまとめて再現コードも含めたもの、課題を見つけてもすぐ直さず温めておく場所</li> <li>eval: 課題を解決する方法を検証するために、A vs Bなどの検証を行う場所</li> <li>src: 実際のコード置き場、課題解決方法で検証が終わったあとにここに変更を加える</li> <li>tests: 課題解決方法で検証が終わったものに対して再発しないようにCheckを入れる場所</li> <li>docs: 諸々のドキュメントをまとめる。意思決定のログなども</li> </ul> <p>つまり、観測 → 再現 → 仮説 → 比較検証 → 本番昇格 → 再発防止という流れ。</p> <h2 id="hddのエッセンス">HDDのエッセンス</h2> <ul> <li>runs <ul> <li>runsは実行時のログは実行時の画像や動画、音声も含めてjsonlなどで全ての実行ログを保存しておく</li> <li>例えば、<code>runs/2024-1010-1012/{001_face.jpg, 001_out.txt, 002_voice.wav, logs.jsonl}</code>みたいな感じ</li> <li>runsの狙いは、問題の原因を一発で探せるようになり、AIがguessで解答させなくする目的</li> </ul> </li> <li>issues <ul> <li>issuesは問題が起きてもすぐ直さず、runsのデータから再現をさせて一旦放置する場所</li> <li>そこでまずは問題をrunsのログをベースに再現できる形にする</li> <li>その上で原因の特定や解決方法の仮説を出す</li> <li>その理由はその課題を解決することによるside effectもあるし、実はedge caseだったりすることもあるから</li> <li>つまり、課題-&gt;解決とは安易に進まないための場所</li> </ul> </li> <li>tests <ul> <li>課題に対して再発しないように回帰テストを入れる</li> <li>なお、失敗に対してもxfail（期待通り失敗）も入れる</li> </ul> </li> <li>全体 <ul> <li>一番大切なのはdon&rsquo;t guess, measure</li> <li>また、solutionに安易に飛びつかないこと</li> </ul> </li> </ul> <h2 id="まとめ">まとめ</h2> <ul> <li>AIによるシーソーゲームの解決方法はHDD</li> <li>HDDはラチェットを締めるように開発する手法</li> <li>つまり「一方向には進むが、逆戻りしない歯車」みたいに開発を進めるべき</li> <li>言い換えると、探索と本番コードを分離し、検証済みの知識だけを一方向に昇格させる仕組み</li> <li>奇しくも、ローカルでgithubのissueやPRを再現している事に近い</li> </ul>