概要
https://creators.bengo4.com/entry/2025/09/03/080000
詳細内容
## claude-code-spec-workflowで始める仕様書駆動開発
https://creators.bengo4.com/entry/2025/09/03/080000
弁護士ドットコムのエンジニアが、AIエージェントの意図逸脱を防ぎ開発プロセスを効率化する「仕様書駆動開発」をClaude Codeで実現するCLIツール「claude-code-spec-workflow」を紹介します。
**Content Type**: ⚙️ Tools
**Scores**: Signal:4/5 | Depth:4/5 | Unique:4/5 | Practical:5/5 | Anti-Hype:4/5
**Main Journal**: 86/100 | **Annex Potential**: 84/100 | **Overall**: 84/100
**Topics**: [[AIエージェント, 仕様書駆動開発, Claude Code, 開発ワークフロー, タスク分割]]
この記事では、AIエージェントを用いた開発で頻発する「意図しない挙動」や「収拾がつかない寄り道」といった課題に対し、AWS Kiroが提唱する「仕様書駆動開発（Spec-driven Development）」の概念をClaude Code向けに実装したCLIツール「claude-code-spec-workflow」を紹介しています。
Webアプリケーションエンジニアにとって重要なのは、AIエージェントが「今何をしているのか、なぜそうしているのか」を明確に把握し、開発をコントロールする手段です。claude-code-spec-workflowは、要件定義から設計、実装計画までをrequirements.md, design.md, tasks.mdといった仕様書としてユーザーと対話しながら具体化し、自己レビュー機能を持つサブエージェントが仕様書を改善する点が画期的です。これにより、人間のレビュー負担を軽減し、認識の齟齬を防ぎます。
さらに、実装計画を細分化されたタスク単位のカスタムコマンドとして生成し、これをサブエージェント内で実行する仕組みは、AIエージェントのコンテキスト圧迫を抑え、「暴走」や「寄り道」といったAI特有の問題を劇的に減少させます。ダッシュボードで進捗をGUIで確認できるため、プロジェクトの透明性も向上します。
実際に2週間使用した経験から、最も大きな効果として「AIの意図を理解できるようになった」点を挙げています。実装意図が仕様書として残るため、将来的なコードの理解や保守性向上にも寄与します。ただし、タスク粒度によってはカスタムコマンドの実行が煩雑になる、AIが過度に厳格なテストを提案するといった課題も指摘しており、設計・タスクレビューの重要性を強調しています。
本ツールは、AIエージェントの力を最大限に引き出しつつ、その制御不能な側面をマネジメントしたいと考える開発者にとって、すぐに試すべき実用的なソリューションを提供します。従来のTDD（テスト駆動開発）と並行、あるいは代替する「AIエージェントに特化した仕様具体化手法」としての可能性も示唆しており、今後のAI開発ワークフローを大きく変革する一歩となるでしょう。