OpenSpecのproposalにbrainstormingを持たせてみた

KAG AI Week 2026 Summer Day 5

Transcript

1. OpenSpecのproposalに brainstormingを持たせてみた KAG AI Week Summer Day 5 2026年7月17日 南川 虎之介
2. 1 KDDI Agile Development Center Corporation 自己紹介 南川 虎之介 KDDIアジャイル開発センター 2年目 ソフトウェアエンジニア とことんAIを使いながらたくさん実験するチームに所属！ 最近ドラクエ10に復帰（バージョン8でストーリー完結するみたいなので）
3. 2 KDDI Agile Development Center Corporation 今日の話 • 「対話のしやすさ」と「仕様の鮮度」を両立するツールがなかった • OpenSpecはカスタムschemaで自分好みに拡張できるので、OpenSpecを導入して proposalフェーズをカスタムした • たくさん実験していこう！
4. 3 KDDI Agile Development Center Corporation 仕様駆動開発ツール変遷まとめ Kiro AWSの仕様駆動開発エージェ ント搭載統合開発基盤 cc-sdd Kiro式をClaude Codeなどで 使えるようにしたコマンド集 Superpowers 対話型仕様駆動プラグイン OpenSpec 仕様を最新に保つことができ る仕様駆動ツール 仕様駆動開発の流れ 要件 設計 タスク 実装 どのツールも大枠はこの流れ レビュー レビュー レビュー レビュー
5. 4 KDDI Agile Development Center Corporation 仕様駆動導入期 Kiro AWSの仕様駆動開発エージェ ント搭載統合開発基盤 cc-sdd Kiro式をClaude Codeなどで 使えるようにしたコマンド集 Superpowers 対話型仕様駆動プラグイン OpenSpec 仕様を最新に保つことができ る仕様駆動ツール 導入理由 • 「いい設計はいい実装を生む」とわかり、仕様駆 動開発を導入した つらいこと • Designまたは実装が生成されてから気づく Requirementsの不足 • 書いていないことには気づけない • 設計ドキュメントが長く、レビューが辛い • 既存の仕様を更新すると既存ドキュメントが全て 変わり、デグレしていないかのレビューが辛い
6. 5 KDDI Agile Development Center Corporation Superpowersの基本フロー brainstorming writing-plans subagent- driven- development brainstorming ファイル構成
7. 6 KDDI Agile Development Center Corporation Superpowers期 Kiro AWSの仕様駆動開発エージェ ント搭載統合開発基盤 cc-sdd Kiro式をClaude Codeなどで 使えるようにしたコマンド集 Superpowers 対話型仕様駆動プラグイン OpenSpec 仕様を最新に保つことができ る仕様駆動ツール 良かったこと • ドキュメントが軽い • 一問一答形式で要件を詰めていくため、理解しや すいし答えやすい つらいこと • specファイル名に日付こそ入るものの使い捨てな 感じがあり、古い仕様が参照される可能性がある • 「意図こそが真実の源」にしたい → これがOpenSpec移行の動機に The GitHub Blog. 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. 7 KDDI Agile Development Center Corporation OpenSpecの基本フロー specs/ は常にシステムの今を表す ＝ 仕様のSSOT（Single Source of Truth） proposal design specs tasks delta spec（変更差分） 追加・変更・削除する仕様だけを書く archive
9. 8 KDDI Agile Development Center Corporation 一問一答形式が欲しいんだ OpenSpecめっちゃいいじゃん！でも Superpowers:brainstormingの 一問一答形式が欲しい…！ custom schemaってものがあるんだ！
10. 9 KDDI Agile Development Center Corporation brainstormを足す • OpenSpecのcustom schema（schema fork）を使い、proposalフェーズに superpowers:brainstormingのような独自の「一問一答・複数案比較」の設計を追加 • brainstormは対話のみでファイルを生成せず、合意結果は直接proposal.mdに統合 brainstorm = proposal design specs tasks NEW
11. 10 KDDI Agile Development Center Corporation ちなみに • 最初はbrainstorm.mdを生成する形だったが、proposal.mdと内容が重複して二度手間に気づいて、 ファイルを増やさない今の形に改善 Before brainstorm brainstorm.md proposal After brainstorm = proposal proposal.md proposal.md
12. 11 KDDI Agile Development Center Corporation • 「今の仕様」が常に正しい状態に保たれているため、新しくchangesを切るときの、AIの 現状把握にかかる時間が減った • 設計フェーズのレビューが重たくて気持ちが沈むことがなくなった • Custom Schemaを使うことで自由度が増した 効果
13. 12 KDDI Agile Development Center Corporation ついでに • cc-sddで育てていたsteering-hogehogeを各フェーズで読み込むようにschema修正 • （OpenSpecだからではなく）生成されたmdファイルの読みづらさを感じてきたため、 mdをもとにHTMLを生成するスクリプトを使って読みやすい形にしてレビューしている
14. 13 KDDI Agile Development Center Corporation • 新メンバーが入った時にOpenSpecのディレクトリをAIに渡して会話するだけでアーキテ クチャやドメイン知識を理解できるのか？ • レビュー時の人間の判断をどう仕様に蒸留していくか • /opsx:archiveのタイミングで、セッション記録からsteeringにマージしていく？ • 設計や実装などのフェーズごとに、AIの提案や実装をどれくらいそのまま受け入れている かを測ってみたい 今後の課題
15. 14 KDDI Agile Development Center Corporation まとめ • 対話のしやすさと仕様の鮮度は、自分でカスタムschemaを書けば両立できる • AIの現状把握が速くなった • 設計レビューで気持ちが沈まなくなった • 今後もたくさん実験していく！
16. Be a Change Leader. アジャイルに力を与え 共に成長し続ける社会を創る