Chapter 36: チーム開発での AI 運用

# AI 活用ガイドライン v1.0

## 推奨する使い方
- ボイラープレートコードの生成
- テストケースの網羅的な生成
- コードレビューの補助（AI レビュー後に人間がダブルチェック）
- ドキュメントの初稿作成
- バグ原因の調査補助

## 注意が必要な使い方
- 複雑なビジネスロジック: AI の出力を必ず人間が検証する
- セキュリティ関連コード: セキュリティ専門家が最終確認する
- 外部 API の呼び出し: 料金・レート制限を確認してから使う

## 禁止事項
- 機密情報（APIキー・個人情報・未公開製品情報）を AI に入力しない
- AI が生成したコードを理解せずにコミットしない
- 本番 DB への直接操作を AI に委ねない

## AI 生成コードのコミットルール
- コメントに `# AI-assisted` を付けることは不要（品質が保たれていれば起源は問わない）
- AI が生成した危険なコードをそのまま使った場合は作成者の責任

project/
├── CLAUDE.md          # チーム共有の AI コンテキスト（git 管理）
├── .claude/
│   ├── settings.json  # チーム共有設定（git 管理）
│   ├── settings.local.json  # 個人設定（.gitignore）
│   ├── agents/        # チーム共有エージェント定義
│   └── skills/        # チーム共有スキル定義
└── docs/
    └── knowledges/
        ├── architecture.md  # 設計意図・背景
        ├── gotchas.md       # ハマりポイント
        └── conventions.md   # プロジェクト規約

## Prisma の `findMany` は N+1 問題を引き起こしやすい

**現象**: User 一覧を取得して各 User の Post を参照すると、
Post のクエリが User の数だけ発行される。

**原因**: Prisma はデフォルトで遅延ロードしない。
明示的に `include` しないと別クエリになる。

**解決策**:
```typescript
// ❌ 問題のある書き方
const users = await prisma.user.findMany();
for (const user of users) {
  const posts = await prisma.post.findMany({ where: { userId: user.id } });
}

// ✅ 正しい書き方
const users = await prisma.user.findMany({
  include: { posts: true }
});
```

**発見者**: @yamada | 2024-03-15

# .claudeignore
.env
.env.*
*.pem
*.key
secrets/
credentials/
**/private/**

# ❌ 危険: プロンプトに直接貼る
claude -p "AWS_SECRET_KEY=AKIAXXXX で S3 にアクセスして"

# ✅ 安全: 環境変数経由
export AWS_SECRET_KEY=$(aws configure get aws_secret_access_key)
claude -p "AWS_SECRET_KEY 環境変数を使って S3 にアクセスして"

新メンバーへの初日ガイド:

1. プロジェクトをクローンして Claude Code を起動
2. 「このプロジェクトの全体構成を説明して」と聞く
3. 「認証フローはどこに実装されている?」と聞く
4. 「このプロジェクトで気を付けるべきポイントは?」と聞く

<!-- .claude/skills/onboarding.md -->
---
name: オンボーディングガイド
command: onboarding
description: 新メンバー向けプロジェクト案内
---

このプロジェクトに初めて参加したメンバーを案内してください。

1. プロジェクトの目的と主要機能を説明する
2. 主要なディレクトリ構成と各フォルダの役割を説明する
3. ローカル環境構築手順（CLAUDE.md または README を参照）
4. よくある質問と回答（docs/knowledges/gotchas.md から抜粋）
5. 最初に触るべきファイルと Issue を提案する

新メンバーへのメッセージ:

「コードを書いたら、まず Claude Code に
 『このコードを上級エンジニアの視点でレビューして、
   改善点を優しく教えて』と頼んでみてください。
 人間のレビュアーへの PR を出す前の自己チェックとして活用できます。」