skanehira/utility-creating-rules

Creating Rules

.claude/rules/ディレクトリにベストプラクティスに沿ったルールファイルを作成する。

ワークフロー

1. 要件の確認

ユーザーに以下を確認：

• ルールのトピック（例：コードスタイル、テスト、セキュリティ）
• 対象ファイル（特定のパスに限定するか）
• サブディレクトリに配置するか

2. ルールファイルの作成

ディレクトリ構造

.claude/rules/
├── code-style.md      # 全体に適用
├── testing.md         # 全体に適用
├── frontend/          # サブディレクトリで整理
│   ├── react.md
│   └── styles.md
└── backend/
    ├── api.md
    └── database.md

ファイル形式

条件なしルール（全ファイルに適用）:

# [トピック名]

- ルール1
- ルール2

条件付きルール（特定ファイルのみ適用）:

---
paths: src/**/*.ts
---

# [トピック名]

- ルール1
- ルール2

paths globパターン

| パターン | マッチ対象 | |---------|-----------| | **/*.ts | 全ディレクトリのTypeScriptファイル | | src/**/* | src/以下の全ファイル | | *.md | ルートのMarkdownファイル | | src/**/*.{ts,tsx} | src/以下のTS/TSXファイル | | {src,lib}/**/*.ts, tests/**/*.test.ts | 複数パターンの組み合わせ |

3. ベストプラクティス

詳細は references/best-practices.md を参照。

要点:

• 焦点を絞る: 1ファイル1トピック
• 説明的なファイル名: 内容が分かる名前
• 条件付きルールは控えめに: 本当に必要な場合のみpathsを使用
• サブディレクトリで整理: 関連ルールをグループ化
• 具体的に記述: 「コードを適切にフォーマット」より「2スペースインデントを使用」

4. 作成後の検証

作成したルールファイルを検証：

1. 配置確認: .claude/rules/に正しく配置されているか
2. 構文確認: frontmatterのYAML構文が正しいか
3. パターン確認: pathsのglobパターンが意図通りか
4. 内容確認: ルールが具体的で実行可能か

検証コマンド例:

# ファイル一覧を確認
ls -la .claude/rules/

# frontmatterの構文確認（pathsが正しいか）
head -10 .claude/rules/[ファイル名].md

問題があれば修正し、再度検証する。

5. 完了確認

• ルールが正しく読み込まれることを確認
• /memoryコマンドで読み込み状況を確認可能