Spec駆動開発体験記

2026.6.19 JAWS-UG山梨 登壇資料
#jawsug #jawsug_yamanashi
KiroのSpec機能を使ってWebページを作成して学んだこと

Transcript

1. JAWS-UG 山梨 第12回勉強会 Spec駆動開発体験記 中原 加寸美 2026/6/20 #jawsug_yamanashi #jawsug 1
2. 中原 加寸美 - Kasumi Nakahara - 出身 佐賀県 好きなAWSサービス IAM Identity Center 趣味 着物 着物でJAWS-UGイベントに出没します [New!] 最近、転職しました 2 2026/6/20 #jawsug_yamanashi #jawsug
3. 今日話すこと 話すこと • Spec駆動開発の簡単な説明 • 実際にやったこと • やってみて感じたこと 話さないこと • Spec駆動開発の詳細な説明 • 作成したWebページの詳細 な説明 2026/6/20 #jawsug_yamanashi #jawsug 3
4. 01 作ってみた 2026/6/20 #jawsug_yamanashi #jawsug 4
5. 今回作ってみたWebページ 2026/6/20 #jawsug_yamanashi #jawsug 5 CVD Vision Simulator 色覚多様性シミュレーションツール 色覚多様性とは？ 日本では「色盲」や「色覚異常」と呼ばれることが多い。近年は見 え方の多様性の一つであるという考え方から「色覚多様性」と呼 ばれることもある。 光を感じ取る目の細胞の働きにより、一部の色の組み合わせの 区別がつきづらい状態を指す。
6. 構成 2026/6/20 #jawsug_yamanashi #jawsug 6
7. なぜ作ったのか？ 2026/6/20 #jawsug_yamanashi #jawsug 9 以前から「色」についての興味があったので、人間が色を 感じるメカニズムについて調べていた 2 3 そのうち作りたいと 思っていた 転職前、有給消化中 に時間があった 1
8. なぜ作ったのか？ 2026/6/20 #jawsug_yamanashi #jawsug 10 以前から「色」についての興味があったので、人間が色を 感じるメカニズムについて調べていた 2 3 そのうち作りたいと 思っていた 転職前、有給消化中 に時間があった 1 よし、作るか！！
9. 02 Spec駆動開発 2026/6/20 #jawsug_yamanashi #jawsug 11
10. Spec駆動開発（SDD）とは？ コードを書く前に、仕様（Spec）を明確に定義し、文書化して進める開発手法 2026/6/20 #jawsug_yamanashi #jawsug 13 設計書 (design.md) の作成 タスク (tasks.md) の作成 実装 Kiro の Spec を使ったときの流れ レビュー レビュー レビュー 要件定義書 (requirements. md)の作成
11. Spec駆動開発(SDD)とは？ ！ポイント！ 各フェーズで「人間によるレビュー」をする 何がいいのか • 文書として整理されており、記憶に依存しない • 最初に仕様が確定しているため、結合時のミスが少ない 2026/6/20 #jawsug_yamanashi #jawsug 14
12. 03 体験記 2026/6/20 #jawsug_yamanashi #jawsug 15
13. 私がやったこと 2026/6/20 #jawsug_yamanashi #jawsug 16 CVD Vision Simulator
14. バグ発見 完成当日に「できた！」と共有したらバグを発見 2026/6/20 #jawsug_yamanashi #jawsug 17 バグ内容 iPhone から画像をアップロードした場合に画像変換失敗のエラーが発生して しまう ⇒本来であれば、対応していないファイル形式のエラーが発生 原因 iPhone で撮った写真は heic 形式で保存されるが、iPhone (または iPad) の Safari で実行した場合に jpeg 形式と誤認される
15. バグ修正 今回はバグ修正もSpec機能を利用した 原因特定 ⇒ 修正の方針を Kiro と一緒に決めていく 2026/6/20 #jawsug_yamanashi #jawsug 18 設計書 (design.md) の作成 タスク (tasks.md) の作成 実装 レビュー レビュー レビュー 要件定義書 (bugfix.md) の作成
16. 体験して感じたこと 2026/6/20 #jawsug_yamanashi #jawsug 19 意外と苦労しなかったな…
17. 体験して感じたこと 2026/6/20 #jawsug_yamanashi #jawsug 20 なぜ苦労しなかったのか考えてみる
18. なぜ苦労しなかったのか？ 1. 作りたいものが明確だった 仕様が確定していた 2026/6/20 #jawsug_yamanashi #jawsug 24 画像をアップロードして 型を選んで 変換ボタンを押したら 元の画像と比較できる システム動作 フロントは CloudFront＋S３ バックエンドは API Gateway＋ Lambda アーキテクチャ AWS SAMで作成 ランタイムはPython 仕様技術
19. 実はAIを使った失敗体験があった バイブコーディングでの失敗 • 一貫した仕様を持たせることが難しい • 言っていることがセッションごとに違う 2026/6/20 #jawsug_yamanashi #jawsug 25 Spec機能を使った失敗 • 途中で仕様を変えようとした • （Kiroが発展途上で途中でバグって無限ループした、 現在は修正済み）
20. 学んだこと Spec駆動開発はいかに仕様が定まっているか、 きちんと要件定義ができるかが肝 でもちょっとしたことにこれを使うのはコストがかかりすぎる 2026/6/20 #jawsug_yamanashi #jawsug 27
21. 学んだこと Spec駆動開発はいかに仕様が定まっているか、 きちんと要件定義ができるかが肝 2026/6/20 #jawsug_yamanashi #jawsug 28 当たり前のことかもしれないけど、 これを機に自分を振り返ってみてもいいかも
22. 04 今後の活用 2026/6/20 #jawsug_yamanashi #jawsug 29
23. 今後の活用 Spec駆動開発の上手な使い方を学んでいきたい もっと規模が大きいシステムも活用して作ってみたい 一方で バイブコーディングとSpec駆動開発の使い分けを学びたい 2026/6/20 #jawsug_yamanashi #jawsug 31
24. 0５ おまけ 2026/6/20 #jawsug_yamanashi #jawsug 32
25. 余談 実際に2型色覚の人に２つの画像を見比べて もらったら「同じじゃん」って言われた 飲み会の場でちょっとした話題を提供できた のでヨシ！！ 実際に見比べてもらった画像⇒ 2026/6/20 #jawsug_yamanashi #jawsug 33
26. 2026/6/20 #jawsug_yamanashi #jawsug 34 THANK YOU !