設定で「リポジトリからルールを自動同期」を有効にしてください
ルールファイル検出とは？
ルールファイル検出は、リポジトリ内の人気の AI コーディングツールとアシスタントからの設定ファイルを自動的に検出・インポートします。これにより、手動セットアップなしで Kody が既存のコーディング標準を理解して尊重できます。サポートされているルールファイル
Kodus は以下のルールファイルパターンを自動的に検出・インポートします：Cursor
.cursorrules- メイン Cursor ルールファイル（レガシー）.cursor/rules/**/*.mdc- サブディレクトリの Cursor ルール
GitHub Copilot
.github/copilot-instructions.md- Copilot の指示.github/instructions/**/*.instructions.md- 詳細な指示ファイル
Agentic（agents.md 規約）
AGENTS.md- エージェント向けガイダンスの事実上の標準ファイル.agents.md/.agent.md- ドットファイルの派生形
Claude
CLAUDE.md- Claude 固有のルール.claude/settings.json- Claude の設定
Windsurf
.windsurfrules- Windsurf IDE のルール
Sourcegraph Cody
.sourcegraph/**/*.rule.md- Cody のルールファイル
OpenCode
.opencode.json- OpenCode の設定
Aider
.aider.conf.yml- Aider の設定.aiderignore- Aider の無視パターン
汎用/内部ルール
.rules/**/*- 汎用ルールディレクトリ.kody/rules/**とrules/**/*.md- Kody 固有のルール（リポジトリルール を参照 — LLM による書き換えなしでそのままインポートされます）docs/coding-standards/**/*- ドキュメントベースのコーディング標準
検出の詳細
- ネストされたファイルも検出されます。 上記のすべてのパターンは、リポジトリのルートおよびあらゆるサブディレクトリで照合されます。
services/billing/CLAUDE.mdはインポートされ、自動的にservices/billing/**にスコープされます — ディレクトリごとのガイダンスファイル（モノレポでよくある慣習）がそのまま機能します。 - 大文字・小文字は区別しません。
claude.mdとCLAUDE.mdは同じものとして扱われます。 @file参照はたどられます。 ルールファイルが標準の@記法で別ファイルを参照している場合（例：CLAUDE.md内の@AGENTS.md）、参照先の内容が取得されインポート時に含まれます（1 階層まで、1 ファイルあたり最大 5 参照、参照ファイルあたり 100KB）。- 1 つのルールに複数のグロブを指定できます。
app/**/*.rb,lib/**/*.rbのようなパス（または リポジトリルール のフロントマターにおけるpath: []のリスト）は、いずれかのグロブに一致するファイルにルールを適用します。
仕組み
初期セットアップ
- 自動同期を有効にする：設定で「リポジトリからルールを自動同期」オプションをトグルします
- 初回同期モーダル：初回同期を行うかどうかを確認するモーダルが表示されます
- リポジトリスキャン：確認すると、Kodus はサポートされているルールファイルのためにリポジトリ全体をスキャンします
- ルール生成：LLM が見つかったファイルを処理し、対応する Kody ルールを自動的に作成します。例外として、
.kody/rules/**とrules/**/*.mdのテンプレートファイルは そのまま（LLM 変換なしで）インポートされ、記述した指示・例・識別子がそのまま保持されます。これらのファイルがテンプレートに沿っていない場合（フロントマターが無い／不正、またはtitleが無い）は、LLM 経路にフォールバックします
継続的な同期
- 自動更新：プルリクエストがクローズされると自動的に同期が行われます
- ファイルの変更が検出される：
- 新しいルールファイル → 新しい Kody ルールを作成
- 変更されたルールファイル → 既存の Kody ルールを更新
- 削除されたルールファイル → 対応する Kody ルールを削除
手動同期（トグル無効時）
自動同期を有効にせずに個別のルールファイルを同期できます：- ルールファイルの任意の場所に
@kody-syncを追加します - 変更をコミットします
- Kody はその特定のファイルのみを同期します
ファイルを除外する（@kody-ignore）
ルール／ガイダンスファイルをリポジトリに残したまま、Kody が Kody Rules に変換しないようにするには、ファイル内のどこかに @kody-ignore を追加します：
- ルールファイルのどこかに
@kody-ignoreを追加（大文字・小文字は区別しません） - 変更をコミット
@kody-ignore マーカーを外す（または @kody-sync を追加する）と、ルールは自動的に戻ります。CLAUDE.md や AGENTS.md のような社内スタイル文書を、レビューで強制されるルールにせずリポジトリに置いておきたい場合に使います。
同期とルール評価の確認（セルフホスト）
セルフホストのデプロイでは、API のログに grep しやすいマーカーが出力されます：[kody-rules-sync]— 実行ごとの同期サマリー：どのファイルがインポート・スキップ（理由付き）・削除されたか。[kody-rules-eval]— レビュー中のファイル単位の評価トレース：レビュー対象ファイルごとに、どのルール（uuid + タイトル）がプロンプトに選ばれたか。
[kody-rules-eval] に一度も現れないルールがある場合は、その Path グロブを確認してください — ルールはパスに一致するファイルでしか実行されません。