チーム開発でのCLAUDE.md運用術

.gitignoreに追加する内容

# Claude Code個人設定
.claude/settings.local.json

# メモリファイル（個人の会話履歴）
# ※ MEMORY.mdは~/.claude/配下に保存されるため通常は不要

{
  "permissions": {
    "allow": [
      "Bash(git status)", "Bash(git diff*)", "Bash(git log*)",
      "Bash(npm test*)", "Bash(npm run lint*)",
      "Read", "Write", "Edit", "Glob", "Grep"
    ],
    "deny": [
      "Bash(rm -rf /)*",
      "Bash(git push --force)*",
      "Bash(git reset --hard)*"
    ]
  },
  "instructions": "CLAUDE.mdに記述することを推奨。例: [
    "Conventional Commits形式でコミットメッセージを書く",
    "関数にはJSDocコメントを必ず付ける",
    "テストファイルは対象ファイルと同じ階層の__tests__/に置く"
  ]
}

{
  "env": {
    "OPENAI_API_KEY": "sk-xxxxxxxxxxxx",
    "DATABASE_URL": "postgresql://user:pass@localhost/mydb"
  },
  "instructions": "CLAUDE.mdに記述することを推奨。例: [
    "コメントは日本語で書いてほしい",
    "型推論できる場合でも明示的に型注釈を書く"
  ]
}

規約記載の例

## コーディング規約

### 必須ルール
- TypeScript strict mode を有効にする
- any 型は使用禁止（unknown + 型ガードを使う）
- API呼び出しは必ず try-catch で囲む
- コンポーネントのpropsは必ず interface で定義

### 推奨ルール
- 関数は30行以内に収める
- ネストは3段階以内に抑える
- マジックナンバーは定数化する

### ESLint/Prettier設定
- ESLint設定: `.eslintrc.json`
- Prettier設定: `.prettierrc`
- コミット前に `npm run lint` を実行すること

コンフリクト防止策

1. セクションごとに担当者を決める
   - 技術スタック → テックリード
   - コーディング規約 → 全員でレビュー
   - デプロイ手順 → インフラ担当

2. PRでの変更を小さく保つ
   - CLAUDE.mdの変更は独立したコミットにする
   - 大きな変更は事前にチームに通知

3. 定期レビュー
   - 月1回、CLAUDE.mdの棚卸しを実施
   - 古い情報の削除・更新を行う

GitHub Actionsでの自動チェック例

name: Check CLAUDE.md
on: [pull_request]
jobs:
  check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: CLAUDE.mdの存在チェック
        run: test -f CLAUDE.md
      - name: 必須セクションの確認
        run: |
          grep -q "## プロジェクト概要" CLAUDE.md
          grep -q "## 技術スタック" CLAUDE.md
          grep -q "## 開発コマンド" CLAUDE.md