こんにちは！私の名前はヴオンです。
株式会社メディアフュージョンで、生成AIを活用した開発に携わっているベトナム出身のエンジニアです。
AI Codingや生成AIを活用した開発手法について、実務で得た知見や経験を共有していきたいと考えています。
「AI Coding実践：リスク・システム・成果で整理する導入戦略」シリーズ
Part1：AI Codingのリスクと導入基盤
第2回：AI Coding導入前に決めるべき開発ルール（本記事）
はじめに
ChatGPT、Claude、Gemini、GitHub Copilot、Cursorなどの生成AIを活用したAI Coding（AIコーディング）は、多くの企業で導入が進んでいます。
一方で、AIツールを導入しただけでは開発効率やコード品質は向上しません。開発ルールが曖昧なまま利用すると、コード品質のばらつきやレビュー工数の増加、保守性の低下などの課題が発生します。
前回の記事では、「AI Codingで失敗する5つの原因」の一つとして「開発ルールを共有していないこと」を紹介しました。
本記事では、AI Codingを導入する前に決めておきたい開発ルールについて解説します。
なぜ開発ルールが必要なのか
AIはプロジェクト固有のルールを自動的に理解できません。
開発ルールがない場合によく起きる問題は以下の通りです。
| 開発現場の課題 | 発生する問題 |
| コーディングルールが統一されていない | コード品質がばらつく |
| レビュー基準がない | レビュー工数が増える |
| 設計方針が共有されていない | 保守性が低下する |
| セキュリティルールがない | 情報漏えいリスクが高まる |
AIを開発チームの一員として活用するためには、人間とAIが同じルールを共有することが重要です。
AI Coding導入前に決めるべき5つの開発ルール
1. コーディング・アーキテクチャルール
問題
AIはさまざまなコーディングスタイルや設計パターンを学習しています。ルールがないまま利用すると、プロジェクト内でコードや設計にばらつきが生じます。
決めておきたい項目
- 命名規則
- インデント・フォーマット
- コメントルール
- ディレクトリ構成
- MVC、Layered Architecture、Clean Architecture
- Controller・Service・Repositoryの責務
AIへ共有するルール・ドキュメント例
- Cursor Rules
- GitHub Copilot Instructions
- CLAUDE.md
- プロジェクトREADME
ポイント
コーディング規約やアーキテクチャ方針をAIにも共有することで、ロジェクト全体で一貫性のあるコードを維持できます。
2. レビュー・テストルール
問題
AI生成コードには、不具合やセキュリティ上の問題が含まれる可能性があります。
実施したいルールの例
- Code Review
- Unit Test
- Integration Test
- Static Analysis
- Security Scan
ポイント
AI生成コードも通常の開発と同じ品質管理プロセスを実施しましょう。
3. プロンプト作成ルール
問題
AIへの指示が曖昧だと、期待どおりの成果物は得られません。
例
悪い例
ログイン画面を作ってください。
良い例
Spring BootでJWT認証を利用したログインAPIを実装してください。Controller・Service・Repository構成とし、JUnit5によるテストコードも生成してください。
ポイント
チーム内でプロンプトの書き方を標準化することで、AIの回答品質を安定させることができます。
4. セキュリティルール
問題
AIへ機密情報を入力すると、情報漏えいにつながる可能性があります。
AIへ入力しない情報の例
- 顧客情報
- 個人情報
- APIキー
- パスワード
- 未公開のソースコード
- 社内設計書・仕様書
- 契約情報などの機密情報
ポイント
AI利用ガイドラインを整備し、入力できる情報と禁止する情報を明確にしておきましょう。
5. AIツール利用ルール
問題
AIツールにはそれぞれ特徴があります。目的に合わないツールを利用すると、本来期待できる効果を十分に得られません。
| 利用目的 | 推奨ツール |
| 設計・仕様検討 | ChatGPT |
| 長文レビュー | Claude |
| コード補完 | GitHub Copilot |
| AI支援開発 | Cursor |
ポイント
一つのツールに依存するのではなく、目的やプロジェクトに応じて使い分けることが重要です。
AI Coding導入前チェックリスト
AI Coding導入前には、以下を確認しましょう。
✓ コーディング規約
✓ アーキテクチャ方針
✓ レビュー・テスト
✓ プロンプト
✓ セキュリティ
✓ AIツール利用ルール
FAQ
AI Coding導入前に最も重要なルールは何ですか？
コーディング規約とレビュー・テストルールです。これらを整備することで、AI生成コードの品質を安定させることができます。
AIが開発ルールを理解するにはどうすればよいですか？
プロンプトやAI向けガイドラインに、コーディング規約や設計方針を明記することが重要です。
AIに開発ルールを毎回入力する必要がありますか？
いいえ、毎回入力する必要はありません。
Cursor Rules や GitHub Copilot Instructions、Claude.md などを活用することで、AIに開発ルールやプロジェクト固有の情報を継続的に共有できます。
AIツールごとにルールを変える必要がありますか？
基本的な開発ルールは共通化し、必要に応じてツールごとの利用ルールを追加すると運用しやすくなります。
まとめ
AI Codingは、開発者の生産性を大きく向上させる可能性があります。しかし、AIツールを導入するだけでは十分ではありません。
コーディング規約、アーキテクチャ方針、レビュー・テストルール、プロンプト作成ルール、セキュリティルール、AIツール利用ルールを事前に整備することで、AIの能力を最大限に活用できます。
AIを「万能な開発者」と考えるのではなく、人間とAIが共通のルールのもとで協力できる開発環境を構築することが、AI Coding成功への第一歩です。
参考文献
- GitHub Copilot Documentation
https://docs.github.com/en/copilot
- OpenAI Platform Documentation
https://platform.openai.com/docs/overview
- Anthropic Claude Documentation
https://platform.claude.com/docs/en/home
- Google Gemini Documentation
- Cursor Documentation
- Prompt Engineering Guide
