From b64b08a45d875cea40e9be520abfbd7430eb9349 Mon Sep 17 00:00:00 2001
From: vvakame <vvakame+dev@gmail.com>
Date: Sat, 21 Feb 2026 12:32:40 +0900
Subject: [PATCH] =?UTF-8?q?CLAUDE.md=20=E3=81=A8=20Claude=20Code=20?=
 =?UTF-8?q?=E8=A8=AD=E5=AE=9A=E3=82=92=E8=BF=BD=E5=8A=A0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Claude Code がこのリポジトリで作業する際のガイドラインとして
CLAUDE.md を追加。プロジェクト概要・コマンド・ディレクトリ構成・
ルールファイルの規約・書式例を記載。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 .claude/settings.json | 10 ++++++++++
 .gitignore            |  2 ++
 CLAUDE.md             | 46 +++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 58 insertions(+)
 create mode 100644 .claude/settings.json
 create mode 100644 CLAUDE.md

diff --git a/.claude/settings.json b/.claude/settings.json
new file mode 100644
index 0000000..a32bb5a
--- /dev/null
+++ b/.claude/settings.json
@@ -0,0 +1,10 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(npm ci:*)",
+      "Bash(npm test:*)",
+      "Bash(gh pr view:*)",
+      "Bash(gh pr diff:*)"
+    ]
+  }
+}
diff --git a/.gitignore b/.gitignore
index c2658d7..61983f6 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1 +1,3 @@
 node_modules/
+
+.claude/settings.local.json
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..7a1a038
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,46 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## プロジェクト概要
+
+[prh (Proofreading Helper)](https://github.com/prh/prh) 用の校正ルール集。日本語の表記揺れ・技術用語の正式名称・商標の表記統一などを YAML ファイルで管理する。
+
+## コマンド
+
+```bash
+npm ci          # 依存パッケージのインストール
+npm test        # 全 YAML ルールファイルのバリデーション (node test.js)
+```
+
+Node.js >= 22 が必要。テストは全 `.yml` ファイルを `prh.fromYAMLFilePath()` で読み込み、構文エラーがないことを検証する。
+
+## ディレクトリ構成
+
+- `languages/` — 自然言語固有のルール（例: `ja/typo.yml`）
+- `terms/` — 技術用語・商標・ツール固有のルール
+- `media/` — 各媒体（出版社・団体）固有のルール
+- `files/` — ファイルタイプごとの include/exclude 設定
+
+## ルールファイルの規約
+
+- YAML 内で `import` を使ってはならない（root の `prh.yml` と `media/` 内は除く）
+- `media/` 内のルールは他のファイルから参照しない（組み合わせて運用する前提ではないため）
+- `media/` には団体・出版社別ルールを置き、作品別ルールは作品リポジトリで管理
+- 団体内で複数ファイルを置く場合は `media/<団体名>/` のようにディレクトリを切る
+
+## ルールの書式
+
+```yaml
+# 単純な表記統一
+- expected: jQuery
+
+# パターン指定
+- expected: Angular 2
+  pattern: Angular2
+
+# 正規表現
+- expected: すべて
+  pattern: /(全て|総て)/
+  prh: ひらがな推奨
+```