j5ik2o/okite-ai/creating-rules

Creating Claude Code Rules

.claude/rules/ ディレクトリにモジュール化された、焦点を絞ったルールを作成する。

Quick Start

まずユーザーに確認する:

1. スコープ: グローバル（全ファイル）or パス指定（特定ファイルタイプ）？
2. 配置場所: .claude/rules/（プロジェクト用）or ~/.claude/rules/（個人用）？
3. カテゴリ: コードスタイル、テスト、セキュリティ、API、その他？
4. 対象言語/フレームワーク（該当する場合）？

次に既存ルールを確認する:

# プロジェクトのルールを確認
ls -la .claude/rules/
 
# 個人のルールを確認
ls -la ~/.claude/rules/

重複がないことを確認してからルールを作成する。

ルールファイルを作成:

---
paths: src/**/*.ts
---
 
# TypeScript Guidelines
 
-strict モードを使用する
-オブジェクト形状には type より interface を優先
-エクスポートされる関数には明示的な戻り値型を指定

作成前チェック

ルールを作成する前に必ず確認：

1. 既存ルールの確認

``bash ls .claude/rules/ ``

• 同じトピックのルールが存在しないか？
• 既存ルールに追記すべき内容ではないか？

1. CLAUDE.md との重複確認

• CLAUDE.md に同様の内容がないか？
• プロジェクト概要 → CLAUDE.md
• 具体的なコーディング規約 → rules/

1. スコープの適切性

• グローバルルールにすべきか、パス指定すべきか？
• 既存のパス指定ルールと競合しないか？

ルールファイル構造

グローバルルール（Frontmatter なし）

全ファイルに適用：

# Code Style
 
-2スペースインデントを使用
-let より const を優先
-未使用変数を残さない

パス指定ルール（Frontmatter あり）

Claude が一致するファイルを扱う時のみ適用：

---
paths: src/api/**/*.ts
---
 
# API Development Rules
 
-全エンドポイントに入力バリデーションを含める
-標準エラーレスポンス形式を使用
-OpenAPI ドキュメントコメントを含める

YAML Frontmatter

paths フィールド

単一パターン：

paths: src/**/*.ts

ブレース展開による複数パターン：

paths: src/**/*.{ts,tsx}

カンマ区切りパターン：

paths: {src,lib}/**/*.ts, tests/**/*.test.ts

Glob パターンリファレンス

ディレクトリ構成

基本構成

.claude/rules/
├── code-style.md      # 一般的なコーディング規約
├── testing.md         # テスト規約
└── security.md        # セキュリティ要件

サブディレクトリあり

.claude/rules/
├── frontend/
│   ├── react.md
│   └── styles.md
├── backend/
│   ├── api.md
│   └── database.md
└── general.md

全 .md ファイルは再帰的に検出される。

シンボリックリンクによる共有ルール

# 共有ルールディレクトリをシンボリックリンク
ln -s ~/shared-claude-rules .claude/rules/shared
 
# 個別ファイルをシンボリックリンク
ln -s ~/company-standards/security.md .claude/rules/security.md

ベストプラクティス

MUST（必須）

• 1トピック1ファイルで焦点を絞る
• 説明的なファイル名を使用（api-validation.md、rules1.md ではない）
• 具体的に記述する（「適切にフォーマット」ではなく「2スペースインデント」）
• 既存ルールを確認してから新規作成

ALLOWED（許可）

• サブディレクトリによる整理
• シンボリックリンクによる共有ルールの参照
• 複数の paths パターンの指定

MUST NOT（禁止）

• 全部入りファイルの作成

``markdown # ✗ Bad - rules.md に全部入れる # All Rules ## Coding ## Testing ## Deployment ## Security ``

• CLAUDE.md との重複
• CLAUDE.md: プロジェクト概要、共通コマンド、アーキテクチャ
• Rules: 特定のコーディングガイドライン

• 時間依存の情報

```markdown # ✗ Bad

• 2025年1月現在、React 19 の機能を使用

```

• 曖昧な記述

```markdown # ✗ Bad

• 適切にフォーマットする
• 良い命名を使う

```

一般的なルールカテゴリ

詳細な例は examples.md を参照。

コードスタイル

# Code Style
 
-ESLint/Prettier 設定を使用
-本番コードに console.log を残さない
-名前付きエクスポートを優先
-@/ プレフィックスで絶対インポートを使用

テスト

---
paths: **/*.test.{ts,tsx}
---
 
# Testing Standards
 
-Arrange-Act-Assert パターン
-外部依存関係をモック
-エッジケースを明示的にテスト
-新規コードは 80%+ カバレッジを目指す

API 開発

---
paths: src/api/**/*.ts
---
 
# API Guidelines
 
-zod で全入力をバリデーション
-一貫したエラーフォーマットを返す: { error: string, code: string }
-全 5xx エラーをログ
-レスポンスにリクエスト ID を含める

セキュリティ

# Security Requirements
 
-機密データ（パスワード、トークン、PII）をログに残さない
-データベースクエリ前にユーザー入力をサニタイズ
-パラメータ化クエリのみを使用
-ファイルアップロードを検証: タイプ、サイズ、内容

React/Frontend

---
paths: src/components/**/*.tsx
---
 
# React Component Guidelines
 
-関数コンポーネント + hooks を優先
-複雑なロジックはカスタム hooks に抽出
-コストの高いレンダリングには React.memo を使用
-Props インターフェース名: ComponentNameProps

Rules vs CLAUDE.md

Rules を使う場合:

• ガイドラインが特定のファイルタイプやパスに適用される
• 単一トピックに焦点を当てた内容
• チームがモジュール化された整理を望む

CLAUDE.md を使う場合:

• 一般的なプロジェクト情報が全ファイルに適用される
• ビルド/テスト/lint コマンドが頻繁に必要
• アーキテクチャ概要が必要

最終チェックリスト

ルール作成前：

• [ ] 既存ルールを確認した（重複なし）
• [ ] CLAUDE.md との重複を確認した
• [ ] 明確で焦点を絞ったトピックを特定した
• [ ] 適切なスコープを選択した（グローバル or パス指定）
• [ ] 説明的なファイル名を使用した
• [ ] 内容を具体的かつ実行可能にした
• [ ] パス指定の場合、glob パターンをテストした