https://hdknr.github.io/blogs/tags/%E3%82%B3%E3%83%B3%E3%83%86%E3%82%AD%E3%82%B9%E3%83%88%E3%82%A8%E3%83%B3%E3%82%B8%E3%83%8B%E3%82%A2%E3%83%AA%E3%83%B3%E3%82%B0/Recent content in コンテキストエンジニアリング on hdknr blogHugo -- 0.157.0jaThu, 14 May 2026 00:00:00 +0000https://hdknr.github.io/blogs/posts/2026/05/openspec-spec-driven-development/Thu, 14 May 2026 00:00:00 +0000https://hdknr.github.io/blogs/posts/2026/05/openspec-spec-driven-development/<h2 id="はじめに">はじめに</h2> <p>「AIにコードを書かせるのは得意になったが、完成品が要件とずれていて全部作り直しになった」——そんな経験はないだろうか。</p> <p><strong>Vibe coding</strong>（感覚的なプロンプトだけでAIにコーディングさせるスタイル）は手軽な反面、AIとの認識齟齬が後から発覚してリワークが発生するリスクをはらんでいる。</p> <p><strong>OpenSpec</strong> は、その問題を「仕様駆動開発（SDD: Spec-Driven Development）」で解消するフレームワークだ。2025年8月に登場してから急速に普及し、2026年5月時点で⭐50,000超を獲得している。</p> <ul> <li>GitHub: <a href="https://github.com/Fission-AI/OpenSpec">Fission-AI/OpenSpec</a></li> <li>npm: <code>@fission-ai/openspec</code></li> <li>ライセンス: MIT</li> </ul> <h2 id="vibe-codingの落とし穴">Vibe Codingの落とし穴</h2> <p>AIコーディングアシスタントは非常に強力だが、要件がチャット履歴の中にしか存在しない場合、出力は予測不能になりやすい。よくある失敗パターンは次のとおり。</p> <ul> <li>「ざっくり作って」と頼んだら意図と全く異なる設計になった</li> <li>途中で要件変更を伝えたら、AIが古い前提を引きずった</li> <li>長いセッションでコンテキストが失われ、最初の仕様が無視された</li> </ul> <p>OpenSpecはこれを「コードを書く前にAIと仕様に合意する」プロセスを導入することで防ぐ。</p> <h2 id="openspecとは">OpenSpecとは</h2> <p>OpenSpecは、AIコーディングアシスタント向けの軽量な仕様レイヤーを提供するフレームワーク。プロジェクトに <code>openspec/</code> ディレクトリを作り、変更ごとに <strong>proposal・specs・design・tasks</strong> の4つのアーティファクトを生成・管理する。</p> <p><strong>設計哲学:</strong></p> <div class="highlight"><div style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"> <table style="border-spacing:0;padding:0;margin:0;border:0;"><tr><td style="vertical-align:top;padding:0;margin:0;border:0;"> <pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#7f7f7f">1 </span><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#7f7f7f">2 </span><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#7f7f7f">3 </span><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#7f7f7f">4 </span><span style="white-space:pre;-webkit-user-select:none;user-select:none;margin-right:0.4em;padding:0 0.4em 0 0.4em;color:#7f7f7f">5 </span></code></pre></td> <td style="vertical-align:top;padding:0;margin:0;border:0;;width:100%"> <pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>→ fluid not rigid （柔軟、固定フェーズなし） </span></span><span style="display:flex;"><span>→ iterative not waterfall （反復的、ウォーターフォールではない） </span></span><span style="display:flex;"><span>→ easy not complex （シンプル） </span></span><span style="display:flex;"><span>→ built for brownfield （既存プロジェクトにも対応） </span></span><span style="display:flex;"><span>→ scalable from personal projects to enterprises </span></span></code></pre></td></tr></table> </div> </div><h2 id="主要コマンドopsx-スラッシュコマンド">主要コマンド（<code>/opsx:*</code> スラッシュコマンド）</h2> <p>OpenSpecは <code>/opsx:propose</code> から始まる一連のスラッシュコマンドで動作する。</p>