AI駆動開発のコツ

AIコーディング道場勉強会 #5
https://ai-coding-dojo.connpass.com/event/377246/

1. AI駆動開発のコツ 北山一郎
2. 私は誰 • 偽名：北山一郎（@exnono_onon） • 出身：長崎市出身（学校は出島の隣） • 仕事：web系のSE • 技能：Laravel（PHP）、Vue.js、AWS • 資格：応用情報、AWS SAA勉強中 • 趣味：ソーイング始めました
3. 「Cursorって便利だけど使いこなせているのかな？」 「AIって便利だけど使いこなせているのかな？」
4. アジェンダ • 開発の目的 • 作っているもの • 前半に得たもの • AI駆動開発の経験 • PJ開発全体の経験 • その他学習 • まとめ
5. 目的 AI駆動開発を身につけること （期限を決めて何かを作る）
6. 作っているもの • 「鯖コン」マインクラフト統合版サーバー管理システム • ユーザーは自分のみ • EC2インスタンスとマイクラサーバー起動、停止 • バックアップ取得、復元 • マイクラサーバーバージョンアップ • ログ管理 • 開発環境：macOS、Cursor 2.0(Composer)、Dev Containter • 言語：Python、TypeScript
8. まとめ ルールはAGENTS.mdに書いとけ Cursorなら.mdcがおすすめ AIが仕様を拾えるように ブラックボックスにしないこと
9. 前半に得たもの • AI駆動開発の経験 • PJ開発全体の経験 • その他学習
10. AI駆動開発の経験 • 再利用可能な基盤（rules、AGENTS.md） • スペック駆動開発（SDD） • レビューのコツ • UIイメージ（.drawio）をそのまま実装してくれた
11. 再利用可能な基盤（RULES、AGENTS.MD） • 再利用可能な基盤の知識を学んだ（rules、AGENTS.md） • 今まではrulesに追加していたが、AGENTS.mdを作成することで編集が楽になっ た
12. 再利用可能な基盤（RULES、AGENTS.MD）
13. 再利用可能な基盤（RULES、AGENTS.MD） ←Cursor特有 ←様々なエージェントで利用可能
14. AGENTS.md
15. 再利用可能な基盤（RULES、AGENTS.MD） • rules：ユーザー固有設定向き（AIとのコミュニケーションなどを記載） • .mdcやAGENTS.md：プロジェクト向き（コマンドや開発手法などを記載） • PJの進め方、コマンドを明記することでエージェントへの指示が明確になる • タスクドリフト（目標の逸脱）が減少した • コマンドをAGENTS.mdから参照するようになった
16. 再利用可能な基盤（RULES、AGENTS.MD） で得たコツ ルールはAGENTS.mdに書いとけ Cursorなら.mdcがおすすめ
17. 再利用可能な基盤（RULES、AGENTS.MD）
19. 閑話休題っと
20. AI駆動開発の経験 • 再利用可能な基盤（rules、AGENTS.md） • スペック駆動開発（SDD） • レビューのコツ • UIイメージ（.drawio）をそのまま実装してくれた
21. スペック駆動開発（SDD） • 各種仕様書を作成しましょう • 000_general.mdcに書いてみました • タスクドリフト（目標の逸脱）が減少した • チャットが長く続くとたまに発生する • コンテキストの管理 AIが仕様を拾えるように
22. AI駆動開発の経験 • 再利用可能な基盤（rules、AGENTS.md） • スペック駆動開発（SDD） • レビューのコツ • UIイメージ（.drawio）をそのまま実装してくれた
23. レビューのコツ 1. AIに作業させるのは1ファイルずつ • レビュー負荷を下げる • 作業ルールを設ける（AGENTS.mdや.mdc） 2. どうしようもない時はAIにレビューさせる • 複数回実施すること • 今回はPython、TSともに練度が低い＋初めての上流工程が多い（要件定義〜） ブラックボックスにしないこと
24. AI駆動開発の経験 • 再利用可能な基盤（rules、AGENTS.md） • スペック駆動開発（SDD） • レビューのコツ • UIイメージ（.drawio）をそのまま実装してくれた
25. UIイメージ（.DRAWIO）をそのまま実装してくれた Login.png 実装した画面
26. こういう失敗もありました dashbord.drawio 実装した画面
27. UIイメージ（.DRAWIO）をそのまま実装してくれた まとめ • 上手く実装できたりできなかったり • 指示の曖昧さなのか • 今後の課題、cursor 2.0のマルチエージェントでコンペするのも面白そう
28. 前半に得たもの • AI駆動開発の経験 • PJ開発全体の経験 • その他学習
29. PJ開発全体の経験 • 要件定義などの上流工程の経験 • issueで課題管理がやりやすかった • 自動テスト（pytest、vitest）を組み込んで品質を管理
30. ISSUEの内容 AIにIssueを確認させ、作業内容が逸れないように制御 • 背景、目的 • 作業内容 • 関連ファイル • 受け入れ条件 • その他、前提知識、事前情報 特に「関連ファイル」はAIが作業するときに助かるみたい
31. 前半に得たもの • AI駆動開発の経験 • PJ開発全体の経験 • その他学習
32. その他学習 • OAuth2.0やPKCEなどの認証技術 • AWS SAMなどのIaC • そもそものAWS
33. まとめ ルールはAGENTS.mdに書いとけ Cursorなら.mdcがおすすめ AIが仕様を拾えるように ブラックボックスにしないこと
34. AI駆動開発のコツ 北山一郎 ご清聴ありがとうございました