達人に学ぶAIコーディング / ai-coding-learned-from-master

Transcript

1. 達人に学ぶAIコーディング 実践 Claude Code 入門 第4章ほか『スペック駆動開発（仕様駆動開発、SDD）』 株式会社ジェネラティブエージェンツ Generative Agents, Inc.
2. ٢ాਅޗ +"846(ԣ඿ࢧ෦ 4FSWFSMFTT
   $PNNVOJUZ +1 -BOH$IBJO $PNNVOJUZ +1 FUDʜ コミュニティ ʙ ג
   ηΫγϣϯφΠϯ ʙ ג
   δΣωϥςΟϒΤʔδΣϯπ p "84
   4FSWFSMFTT
   )FSP p -BOH$IBJO ެࣜ &YQFSU
   
   "NCBTTBEPS エキスパート
3. バイブコーディングもスペック(仕様)駆動開発 もなかった ”1年前”
4. "*ίʔσΟϯάಓ৔ ϲ݄ΛλʔϜͱͯ͠ɺ"*ίʔσΟϯάͰΞΠσΞͷൃ૝͔Β঎༻αʔϏεΛ ϦϦʔε͢Δ·Ͱ΍Δಓ৔˞ظੜืूத
5. !!ιϑτ΢ΣΞΤϯδχΞϦϯά͕͍ͨ͠ 課題感：ノリでは作れるが、セキュアでロバストなソフトウェアを安全に 本番リリース・運用できないかぎり普及しない औΓ૊Έ͔ͨɾ஌ݟ • ن໛ͷখ͍͞ιϑτ΢ΣΞͷʮ13%࡞੒ʯʮઃܭʯʮ࣮૷ʯʮ؀ڥߏ ஙʯʮςετʯʮӡ༻ʯ͔Β͸͡ΊΔ • *%&͸ͲΕΛબΜͰ΋։ൃϥΠϑαΠΫϧࣗମ͸มΘΒͳ͍ • ແྉʹͩ͜ΘΒͳ͍ˠ΍ΕΔ͜ͱ͕Ͱ͖ΔɺΛ༏ઌ
6. Claude Task Master https://github.com/eyaltoledano/claude-task-master PRDをタスクに分解して管理できるツール（のちにローカルMCPサーバー化 → Taskmaster AI としてCursorやLovableでの利用にも拡張
7. バイブコーディングの壁
9. Claude Codeでスペック駆動開発 • ノリ(Vibe)で作ってみる • 無計画にコード作成をすると、ちゃんと動くアプリケーションができるかもしれないし、できないかもしれない • 想定している機能やエラー処理の考慮もしてくれていない可能性あり • ↓そこで… 1. まず仕様書、設計書をしっかり作って 2. コードを作成し 3. テストを実施する • 通常のソフトウェアエンジニアリングの工程管理を実施する必要性 > タスク管理アプリを作って。React使って、タスクの追加、削除、完了マークができるやつ。 ⏺ React を使ったタスク管理アプリを作成します。 ⏺ Update Todos ⎿ ☐ React アプリの初期セットアップ ☐ タスク管理コンポーネントの作成 ☐ タスクの追加機能の実装 ☐ タスクの削除機能の実装 ☐ タスクの完了マーク機能の実装 ☐ スタイリングの追加
12. スペック駆動開発(Spec-Driven Development)とは
16. όΠϒίʔσΟϯά • ࣗ෼͚ͩͰ࢖͏΋ͷ • Կ͕΄͍͔͠Θ͔Βͳ͍ͷͰ ೚ͤΔ εϖοΫۦಈ։ൃ • ιϑτ΢ΣΞΤϯδχΞϦϯά • ͢΂ͯΛҙਤͲ͓Γʹ੍ޚ͢Δ • ͢΂ͯͷόΠϒίʔσΟϯά͕ յΕΔΘ͚Ͱ͸ͳ͍ ˠ൷൑తͳϨϏϡʔ΍ςετͷ పఈͰվળՄೳ • --.΍ϑϨʔϜϫʔΫͷਐԽΛ ڗडͰ͖ͳ͍Մೳੑ͕͋Δ
17. 開発ルールをClaude Codeで作成する
18. $MBVEF
    $PEFͰεϖοΫۦಈ։ൃ 【スペック駆動開発のやりかた自体もClaude Codeに相談】して、ルールをメモリ(CLAUDE.md)に定義する > まずは開発標準ルールとして、開発を進めるときは必ず以下のドキュメントを参照して開発を進めることとします。 - プロダクト企画書 `product.md` - プロダクトビジョンや目的 - ターゲットユーザーと課題・ニーズ - 主要な機能や目標 - 成功の定義 - 要求仕様書を`requirements.md` - ユーザーストーリー - 受け入れ条件 - 機能設計書 `design.md` - 機能ごとのアーキテクチャ - 構成図 - 技術仕様書 `tech.md` - テクノロジースタックやフレームワーク - 開発ツールや手法 - 技術的な制約事項や要求事項 - 利用するサードパーティ製品 - アプリ構造定義書 `structure.md` - フォルダやファイルの構成 - 命名規則 - コーディング規約 - タスクリスト - 機能やインフラの実装タスク - テストや品質保証タスク 追加開発や修正開発をする際には影響ドキュメントを洗い出して当該ドキュメントを修正してから、新規のタスクリストを作成し、タスクを実行することとし、タ スクリストのファイル名は`tasklist-`+`実施内容を端的に表現した名用`+`作成日時`で作成すること。 また、ドキュメントを編集したときは、1ファイルごとにわたしに必ず確認、承認を得てから次のファイル編集をおこなってください。 これをCLAUDE.mdに整理して定義してください。
19. 永続的ドキュメントと作業バッチドキュメント
22. つくる対象を考慮したドキュメント体系や 開発ルールを考える
23. !!ιϑτ΢ΣΞΤϯδχΞϦϯά͕ͪΌΜͱ΍Γ͍ͨ 工程 サブ工程・視点 プロダクト要求仕様書（PRD）作 成 • ステークホルダー別の要求整理 • 機能要件と非機能要件の明確化 • 受け入れ条件の具体化 既存システムの調査・分析 • データベース設計、API仕様、画面設計の把握 • コードベースの全体像や依存関係の把握 技術選定とアーキテクチャ設計 • 技術スタックの選定 • システムアーキテクチャ(マイクロサービス vs モノリス、データベース設計パターン、パフォーマ ンス設計) 設計 • 機能設計書(画面、フローチャート、シーケンス、画面設計、ビジネスロジック, etc…) • データベース設計、ユーザー認証, etc… • API設計(GraphQL、REST API, etc…) 実装 • コンポーネントの適用、機能実装、認証・認可, etc… テスト駆動開発（TDD） • テストケース設計、テスト品質向上 • モック、APIテスト、DBテスト、E2Eテスト, etc… インフラ構築・CI/CD • インフラ設計 • IaCコード作成 • GitHub Actionsワークフロー作成 • 監視・ログ管理の設計
25. カスタムコマンド化、cc-sddなど