# CLAUDE.md
@FLAGS.md
@RULES.md
@PRINCIPLES.md

---
paths:
  - "src/components/ 配下の .tsx ファイル"
  - "src/components/ 配下の .ts ファイル"
---
# React コンポーネントルール
- 関数コンポーネント + hooks を使用
- default export 必須

特に、# .claude/commands/review.md
以下のコードを次の観点でレビューしてください:
- セキュリティ脆弱性
- パフォーマンス問題
- コーディング規約準拠

対象: $ARGUMENTS

つまり、# .claude/skills/deploy-check/SKILL.md
---
context: fork
allowed-tools:
  - Bash
  - Read
argument-hint: "デプロイ対象の環境名を入力（staging / production）"
---
# デプロイ前チェックスキル
デプロイ前に以下を検証します:
1. テスト全件パス
2. lint エラーなし
3. 環境変数の整合性
対象環境: $ARGUMENTS

# 不安定になりがちな指示
「関数名は分かりやすくしてください」

# 安定する指示（入出力例）
入力: function proc(d) { /* 処理 */ }
期待出力: function processUserData(userData) { /* 処理 */ }

claude -p "コードの問題点を分析してください" \
  --output-format json \
  --json-schema '{"type":"object","properties":{"issues":{"type":"array"}}}'

name: Claude Code Review
on: [pull_request]
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: セキュリティレビュー
        run: |
          claude -p "Review the changes in this PR for security issues" \
            --output-format json
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

~/.claude/CLAUDE.md                  ← ユーザーレベル（個人設定）
├── @PRINCIPLES.md                   ← 個人のコーディング原則

project/CLAUDE.md                    ← プロジェクトレベル（チーム共有）
├── 技術スタック情報
├── Git ブランチ戦略
└── 共通命名規約

project/frontend/CLAUDE.md           ← ディレクトリレベル（フロントエンド固有）
├── React コンポーネント規約
├── TypeScript strict mode ルール
└── CSS-in-JS の使用方針

project/backend/CLAUDE.md            ← ディレクトリレベル（バックエンド固有）
├── FastAPI ルーター構造
├── Pydantic モデル設計規約
└── 非同期処理の方針

つまり、project/.claude/rules/
├── test-conventions.md
│   paths: ["**/*.test.ts", "**/*.test.tsx",
│           "tests/配下の 全 .py", "**/*_test.py"]
│   → テスト命名規約、AAA パターン、モック方針
│
├── api-contracts.md
│   paths: ["project/frontend/src/api/**",
│           "project/backend/app/routers/**"]
│   → API 契約ルール（型の一致、エンドポイント命名）
│
├── terraform-safety.md
│   paths: ["infra/配下の 全 .tf"]
│   → Terraform 変更時の安全確認手順
│
└── ci-config.md
    paths: [".github/**", "Dockerfile",
            "docker-compose*.yml"]
    → CI/CD 設定変更時のルール

例えば、# チーム共有コマンド
project/.claude/commands/
├── review.md          ← /review でコードレビュー
├── api-check.md       ← /api-check でAPI契約の整合性確認
└── deploy-checklist.md ← /deploy-checklist でデプロイ前チェック

# チーム共有スキル
project/.claude/skills/
└── security-scan/SKILL.md
    context: fork
    allowed-tools: [Bash, Read, Grep]
    → 隔離環境でセキュリティスキャン実行

しかし、# GitHub Actions: PRレビュー
name: Claude Code Review
on: [pull_request]
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: セキュリティ・品質レビュー
        run: |
          claude -p "Review this PR for security and quality" \
            --output-format json
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}