Share
Embed
仕様駆動開発の消費期限
AI Native Dev Night Tokyoでお話しした内容になります。
https://kinto-technologies.connpass.com/event/398365/
watany
August 05, 2026
Transcript
51 slides
-
About Me 渡邉 洋平(watany) • • • • 所属:NTTテクノクロス株式会社 AWS
Ambassadors(2024〜) JAWS-UG東京(AWSコミュニティ) 運営 寄稿:CodeZine ◦ 仕様駆動開発への期待と誤解 2026年5月2日(土)発売 https://www.sbcr.jp/product/4815636593/ 2 -
Specification(仕様書)について > A specification is a kind of (version controlled,
human-readable) super prompt. — 仕様書とは、一種の(バージョン 管理され、人間が読める)スー パープロンプトです。 Kiro and the future of AI spec-driven software development https://kiro.dev/blog/kiro-and-the-future-of-software-development/ 7 -
Specification(仕様書)について > That’s why we’re rethinking specifications — not as
static documents, but as living, executable artifacts that evolve with the project. — 仕様書を静的な⽂書ではなく、 プロジェクトと共に進化する⽣ きた実⾏可能な成果物として捉 え直しています。 Spec-driven development with AI: Get started with a new open source toolkit https://github.blog/ai-and-ml/generative-ai/spec-driven-development-with-ai-get-started-with-a-new-open-source-toolkit/ 8 -
仕様駆動開発 (Spec-Driven Development, SDD) 2025/7、AWSがIDE「Kiro」の発表と共に提唱 - 「実装前に仕様(書)を作る」というVibe Coding以後のレトロニム - レトロニム:新しい事物の誕⽣後、既存の事物を区別するため
「後から」作られた⾔葉。例) 固定電話、オンプレミス - 実⽤として以下の側⾯がある 1. フレームワークとしてのAIワークフロー 2. エージェント⽤のドキュメント管理(⻑期記憶) Kiro https://kiro.dev/ 9 -
仕様駆動開発 (Spec-Driven Development, SDD) 2025/7、AWSがIDE「Kiro」の発表と共に提唱 - 「実装前に仕様(書)を作る」というVibe Coding以後のレトロニム - レトロニム:新しい事物の誕⽣後、既存の事物を区別するため
「後から」作られた⾔葉。例) 固定電話、オンプレミス - 実⽤として以下の側⾯がある 1. フレームワークとしてのAIワークフロー 2. エージェント⽤のドキュメント管理(⻑期記憶) Kiro https://kiro.dev/ 11 -
仕様駆動開発のAIワークフロー(共通点) - 仕様駆動開発は、実態として「仕様→設計→タスク化」の ワークフローを核にしている - Kiro: Requirements → Design →
Tasks - Spec-Kit:Specify → Plan → Tasks - OpenSpec:Proposal → Specs → Design → Tasks 15 -
2. エージェント⽤のドキュメント管理(⻑期記憶) spec実装のパターン 1. spec-first: まずspecを書いて開発。 タスク完了後、specを破棄する 2. spec-anchored: タスク完了後も
specを保持。将来の変更‧保守でも specを更新し続ける 3. spec-as-source: specを原本として コードは⽣成される。⼈は直接編集 しない Understanding Spec-Driven-Development: Kiro, spec-kit, and Tessl https://martinfowler.com/articles/exploring-gen-ai/sdd-3-tools.html 16 -
※注:事実上、実⽤されているのは2種類 spec実装のパターン 1. spec-first: まずspecを書いて開発。 タスク完了後、specを破棄する 2. spec-anchored: タスク完了後も specを保持。将来の変更‧保守でも
specを更新し続ける 3. spec-as-source: specを原本として コードは⽣成される。⼈は直接編集 しない Understanding Spec-Driven-Development: Kiro, spec-kit, and Tessl https://martinfowler.com/articles/exploring-gen-ai/sdd-3-tools.html 17 -
”仕様駆動開発”が⽣まれた時期 - 前述の「仕様駆動開発のワークフロー」は2025/7〜2025/9 頃に検討されたもの - 本登壇(2026/8/6)の約⼀年前 - 2025/7〜2025/9(⼀年前)に主流だったモデル - Claude
Sonnet 4, Opus 4.1 - GPT-4o、GPT-4.1、o3 → GPT-5 - DeepSeek V3.1, Qwen3-Coder, gpt-oss 20 -
LLMモデルの転換点 ”仕様駆動開発”(2025/9)以後の⾃⾛性能向上 — > (私訳)2025年11 ⽉の GPT-5.2 と Opus 4.5
は、本当に 転換点を表しているように感じます。 Simon Willison Djangoの共同開発者 https://x.com/karpathy/status/2026731645169185220 -
Spec-firstとは”いつものPlanモード”に⾒える > また、仕様駆動開発のうち Spec-firstのスタイルはPlanモード に合流し、Coding Agentの多くの 実装に含まれる当たり前のものに なりつつあります。 仕様駆動開発への期待と誤解 〜「仕様」とは、結局何なのか〜
https://codezine.jp/article/detail/23908 22 -
Spec-firstとは”いつものPlanモード”に⾒える - spec-first :まずspecを書いて開発。タスク完了後specを破棄 - Plan Mode :計画‧設計から作成したタスクリストの通りに実装 - 初期はReadOnly(Ask)だったが、spec-first化が主流
Plan & Act https://docs.cline.bot/features/plan-and-act Cline v3.25: The Coding Agent Built for Hard Problems https://cline.bot/blog/cline-v3-25 23 -
Planモード不要論 (和訳) > 私はPlanモードを使いません。 > (Planモードが)Codexに追加された 理由は「Claude脳」の利⽤者に向けた 機能だからです。 > ただエージェントと普通に会話すれば
いいのです。 Peter Steinberger OpenClawの開発者 https://x.com/steipete/status/2039551079621566812 24 -
考えて保存するだけならPlanやSpecは必要ない Skills:mattpocock/grill-with-docs - Agentが利⽤者に⼀問ずつ質問する - 決まった⽤語を⽤語集 (CONTEXT.md) に記録 - 重要な設計判断を
docs/adr/ に記録 Matt Pocock 講座「Total TypeScript」の作者 Understanding Spec-Driven-Development: Kiro, spec-kit, and Tessl https://martinfowler.com/articles/exploring-gen-ai/sdd-3-tools.html 25 -
エージェント⽤の記録⽅法はSpec以外にもある LLM Wiki(LLM Knowledge Base) Open Knowledge Format(OKF) - Andrej
Karpathy提唱のナレッジ ベース管理⼿法 Karpathy ⽒が⾔語化した「LLM Knowledge Base」というパターン https://dev.classmethod.jp/articles/karpathy-llm-knowledge-base/ - Google提唱のナレッジ標準化 フォーマット Open Knowledge Format のご紹介 https://cloud.google.com/blog/ja/products/data-analytics/how-the-open-knowle dge-format-can-improve-data-sharing/ 26 -
仕様駆動開発の消費期限 - 「仕様駆動開発のワークフロー」は2025/7〜2025/9頃に 検討されたもの - 本登壇(2026/8/6)の約⼀年前 - 実⽤として以下の側⾯がある - フレームワークとしてのAIワークフロー
- 「事前に作成したタスクリストの実装」はエージェ ントハーネスに⼀般化されている - エージェント⽤のドキュメント管理(⻑期記憶) - 代替のプラクティスが発⾒され、唯⼀無⼆ではない 27 -
AI駆動開発の「守」 - AI駆動開発について「守破離」以前に 守るべき型が無い状況 - ”エンジニアたるもの⽉3000円〜 30000円を負担し、余暇で慣れる”と いう特殊なムードが前提に置されている - ⾃著では可能な限り「型」のベースを
体系化したが、チーム全員に定着させる には難しさがある 31 -
AI駆動開発と「守破離」 - 守破離の3ステップ - 型を守る - 型を破る - 型を離れる -
では、AI駆動開発の「型」とは何を指しているか? 32 -
AI駆動開発のフレームワーク:AI-DLC AI-DLCの実践:AI-DLC Workflows AI-DLC Workflows 2.0 とは何か、そしてどう実装されているか Operation Phase of
AI-DLC - AI 駆動カオスエンジニアリングのすすめ- https://zenn.dev/aws_japan/articles/aidlc-workflows-v2-harness-engineering https://pages.awscloud.com/rs/112-TZM-766/images/R05_0626_DVT452_v2.pdf 34 -
Context Engineering コンテキストを書く / 選ぶ / 縮める / 分ける ための技術
Context Engineering https://blog.langchain.com/context-engineering-for-agents/ 40 -
LLMが参照できる範囲 - Context:プロンプト + 外部情報 - Context Window:LLMの理解 できるトークンの総容量 -
つまり、LLMとの「会話」に おいて、総トークン数が Context Window以内である 必要がある Context Engineering https://blog.langchain.com/context-engineering-for-agents/ 41 -
⼈間が参照できる範囲 - Thoughtworks Technology Radarが 「codebase cognitive debt(認知負債)」 を注意対象として採⽤ -
> (私訳)コードベースの認知的負債とは、シス テムの実装と、「そのシステムがどのように、 なぜそのように動作するのか」というチーム内 の共通理解との間に⽣じる隔たりが、徐々に拡 ⼤していく状態を指します。 Technology Radar https://www.thoughtworks.com/radar/techniques/codebase-cognitive-debt 42 -
”理解負債”について - 2026年の研究では、207⼈の学⽣が8週間にわたり記録した⽇誌 から、GenAIによる「Comprehension Debt」が分析された。 1. ブラックボックスとしてコードを受け⼊れる 2. プロジェクト⽂脈と合わないコードを採⽤する 3.
AI依存により⾃⼒で扱う能⼒が低下する 4. 検証を省略する Comprehension Debt in GenAI-Assisted Software Engineering Projects https://arxiv.org/abs/2604.13277 43 -
”認知負荷”は開発のブレーキになる - ⼈間の理解する速度はAgentにとって のブレーキになり、開発が滞留する - Agentの速度は500PR/day - チームのレビュー能⼒は10PR/day - ”儀式”の⾒直し案
- レビューをコード⽣成の⼀部とする - Agentが⾃⾝の作業を検証する - 敵対的なAgentにレビューさせる The Software Development Lifecycle Is Dead https://boristane.com/blog/the-software-development-lifecycle-is-dead/ -
欲しかった「守」 - 「AI駆動開発の進め⽅」として欲しかったもの - 開発のための規律 - 理解のための形式 - レビューのためのワークフロー、⽣成物 -
「破りやすい」型が欲しかった - AI-DLCは重厚⻑⼤な「型」なので導⼊後のサンクコストや ロックインの影響が気になった - Skillsの寄せ集めの「型なし」では不安があった 47 -
仕様駆動開発の選定 - KiroのSpec機能はスコープから外した - エージェント選定の⾃由を考慮 - モデル性能‧トークンコストなど考慮が必要 - Spec-Kit vs
OpenSpec - Spec-Kitの⽣成するドキュメントは重厚⻑⼤になりやすく、 認知負荷が⾼すぎると判断し、OpenSpecを選択した。 - OpenSpecの良いコマンド - /opsx:verify :仕様と実装の⼀次チェック - /opsx:archive :実装完了後のSpecをarchiveし、メインの仕 様ファイルへ同期する 48 -
仕様駆動開発の消費期限=型を破るタイミング - 「仕様駆動開発」の既知の課題 - コーディングからレビューへ移⾏するボトルネック - 仕様ファイル群の整合性チェック(ドリフト管理) - 仕様という⾔語に拘束され、LLMの性能を発揮できない例 -
最新LLMのベストプラクティスは「プロンプトを減らす」 - 逆にいうと、課題に突き当たるまでは仕様駆動開発は理解しやすい - メンバの作業を適宜⾒ながら意識合わせするという、チーム仕事の基本 - チーム全員が消費期限切れと感じたら、仕様駆動開発の次へ進めば良い 51