CLAUDE.md、AGENTS.md、.cursor/rules、.github/copilot-instructions.md のようなファイルは、チームの作業方法をコーディングエージェントに伝えるものです。これらはレビューポリシーではないため、Kodus が Kody Rules に変換することはありません。この設定をオンにすると、Kody はプルリクエストで変更されたファイルをカバーする指示ファイルを読み、その内容に反する変更を指摘します。
規約をレビューで強制されるルールにしたい場合は、.kody/rules に リポジトリルール として記述してください。
有効にする
- オンボーディング中：Teach Kody how your team builds software ステップで、選択した各リポジトリで見つかったコーディングエージェント向けファイルが一覧表示され、Kody にそれらを使わせるかどうかを尋ねられます。オンにしない限りオフのままです。
- あとから：サイドバーで、Code review グループ上部のスコープピッカーで Global またはリポジトリを選択し、What to review を開いて Coding-agent instructions をオンにします。Global の値は、独自の値を設定していないすべてのリポジトリのデフォルトになります。
kodus-config.yml）に repoInstructionsEnabled として保存されます。以前の ideRulesSyncEnabled はもう読み取られないため、そこに設定した値でこの機能が有効になることはありません。
Kody が読むファイル
Cursor
.cursorrules.cursor/rules/**/*.mdc
GitHub Copilot
.github/copilot-instructions.md.github/instructions/**/*.instructions.md
エージェント（agents.md 規約）
AGENTS.md、.agents.md、.agent.md.agents/rules/**
Claude
CLAUDE.md
Windsurf
.windsurfrules
Sourcegraph Cody
.sourcegraph/**/*.rule.md
.claude/settings.json、.opencode.json、.aider.conf.yml、.aiderignore）は認識されますが、コードを照らし合わせる指示を含まないため、読み込まれることはありません。
Claude のスキル（.claude/skills/**）も読み込まれません。Claude はタスクが必要とするときにだけスキルを読み込むためです。
レビューでの使われ方
- 変更をカバーするファイルだけ。 リポジトリのルートにあるファイルはすべてのファイルをカバーします。
services/billing/CLAUDE.mdのようなネストされたファイルはservices/billing/**をカバーします。globs:を持つ（かつalwaysApply: trueではない）Cursor ルールや、applyTo:を持つ Copilot ファイルは、宣言したファイルだけをカバーします。どちらも持たない Cursor ルールは、Cursor のエージェントが要求したときにだけ読み込まれるため、読み取りません。 - プルリクエストのターゲットブランチから読み込みます。 プルリクエストは、そのブランチにすでにマージされている指示に照らしてチェックされます。プルリクエストで行った指示の変更は、マージ後に反映されます。
- 参照先もたどります。 リポジトリ内の別のファイルを指すファイル(パスだけの行
AI-AGENTS.md、または Claude Code のインポート@docs/guide.md)は、ターゲットブランチで参照先をたどり、その代わりに参照先のファイルを同じ上限の範囲で読み込みます。リポジトリ外のパスは無視されます。 - 上限があります。 1 回のレビューにつき最大 8 ファイル・64 KB まで、変更されたコードに近いファイルが優先されます。長いファイルは切り詰められます。読み込まれなかったものはレビューのログに記録されます。
- 指摘には Repo Instruction のラベルが付きます。 Kody が指摘するのは、指示が変更されたファイルに適用され、かつそれに反する行がプルリクエストで追加または変更された場合だけです。コメントには指示が引用され、ファイル名が示されます。
- レビューのフィルターが適用されます。 Repo Instruction の指摘は、他の指摘と同じくチームの重大度フィルターと提案数の上限を通ります。しきい値を下回る指摘は投稿されません。この設定は Kody にファイルを読ませるもので、それらの上限を超えて投稿させるものではありません。
- Kody への指示としては扱いません。 これらのファイルは、差分と照らし合わせるためのリポジトリ内のテキストとして扱われます。レビュアーに何かを求める記述は無視され、バグ・セキュリティ・パフォーマンスの問題の判断が変わることもありません。
この変更以前にインポートされたルール
以前のバージョンの Kodus は、これらのファイルを Kody Rules に変換していました。それらのルールは残りますが 凍結 されます。ファイルが変更されても更新されず、Kody Rules ページでは Agent file のオリジンが付きます。rules from coding-agent files チップで一覧をそれらのルールに絞り込めるので、一時停止や削除をしたり、強制したい規約を.kody/rules に移したりできます。
オンボーディングで誰も選択しないままコーディングエージェント向けファイルからインポートされたルールは削除されました。各リポジトリにある同じファイルのコピーが、それぞれすべてのリポジトリに適用される別々のルールになっていたためです。Kody Rules ページには削除された件数が表示され、What to review の Coding-agent instructions を有効にすると、各リポジトリのレビューで同じファイルが読み込まれます。削除されたルールを戻したい場合はサポートにお問い合わせください。
@kody-sync はもう何の効果もありません。Kody Rule ファイルは常に同期され、コーディングエージェント向けファイルがルールになることはないためです。@kody-ignore は引き続き Kody Rule ファイルを同期の対象から外します。