[Claude Code] rulesの使い方

CLAUDE.mdに全てのルールを書くと、ファイルが肥大化して管理が難しくなります。
Claude Codeには、rulesという仕組みがあり、領域ごとにルールを分割して管理できます。
この記事では、rulesの使い方と書き方を紹介します。

やすひら

rulesの使い方と書き方を紹介します

rulesとは何か

rulesは、.claude/rules/配下のディレクトリに置くMarkdownファイルです。
CLAUDE.mdがプロジェクト全体への指示であるのに対し、rulesは特定の領域/ファイルに関する指示を分割して管理することができます。

ファイル構成

.claude/
└── rules/
    ├── github-issues.md   # GitHub Issues操作のルール
    ├── blog.md            # ブログ記事作成のルール
    ├── sns.md             # SNS投稿のルール
    └── journal.md         # 日記・レビューのルール

CLAUDE.mdに「このリポジトリ全体の基本ルール」を書き、rulesに「各領域の詳細ルール」を書く、という使い分けが基本です。

あわせて読みたい

[Claude Code] CLAUDE.mdの使い方

rulesファイルの書き方

rulesファイルはMarkdown形式で書きます。
ファイルの先頭にフロントマターを付けることで、適用するパスを指定できます。

設定ファイル

---
description: ブログ記事案の作成ルール
paths:
  - "blog/**"
---

# ブログ記事ルール

## ブログ記事案の作成

1. blog/templates/article.md をコピーして blog/drafts/記事名.md を作成
2. context.md のゴール・価値観に沿った内容で草稿を生成

pathsに指定したディレクトリのファイルを扱うとき、本rulesが自動的に適用されます。

rulesファイルの作り方

rulesファイルを手書きで入力するのは大変です。
AIエージェントに、ルールの作成を依頼することで、rulesファイルを作成することができます。

プロンプト

CLAUDE.md の〇〇に関するルールを .claude/rules/xxx.mdに切り出してください。

ルール作成をプロンプトで指示します。
ルール案を確認して、AIエージェントと会話してルール作成することができます。

プロンプトがわからない場合は、プロンプトの作成方法をAIエージェントに聞けば、適切なプロンプトを回答してくれます。

rulesの定義例

rulesの定義例を紹介します。

GitHub Issues操作のルール

GitHub Issues操作のルールを設定します。

設定ファイル

# GitHub Issue 操作ルール

## ラベルルール

| ラベル | 種別 | 付けるタイミング |
|--------|------|----------------|
| task   | 種別 | 実行すべきタスクのIssue |
| idea   | 種別 | アイデア・検討事項のIssue |
| in-progress | 状態 | 着手したとき |

## よく使う操作

### Issueの作成
gh issue create --title "タイトル" --label "task"

### Issueのクローズ
gh issue close <number> --comment "完了コメント"

このように「よく使うコマンド」「ラベルの使い方」をrulesに書いておくと、AIが正しいコマンドを使ってIssueを操作してくれます。

CLAUDE.mdとrulesの使い分け

CLAUDE.mdとrulesの使い分けについて紹介します。

CLAUDE.mdのルールが増えてきたら、まずrulesに切り出すことを検討してみてください。
CLAUDE.mdをシンプルに保つことで、AIが最初に読む情報量を絞れます。

あわせて読みたい

[Claude Code] CLAUDE.mdの使い方

まとめ

rulesの使い方と書き方を紹介しました。

CLAUDE.mdが肥大化した際に、ルールをrulesに分割することで、高精度な作業が可能になります。