> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ルール

Qoder では、プロジェクトごとのルールを設定できます。これらのルールは `.qoder/rules` ディレクトリに保存され、現在のプロジェクトにのみ適用されます。プロジェクトのフレームワークやコードスタイルなど、あなたのコーディングの好みに合わせてモデルの適応を最適化します。

<div id="how-rules-work">
  ## **ルールの仕組み**
</div>

大規模言語モデル（LLM）は一般的な知識に依存しているため、プロジェクト固有のcontextやルールを把握していません。Qoderのルールは、あらかじめ定義したcontextをプロンプトに戦略的に挿入することでこの課題に対処し、AIの応答がプロジェクトの標準や要件に一貫して沿うよう導きます。

<div id="storage-and-sharing">
  ### **保存と共有**
</div>

* ルールファイルはプロジェクトディレクトリに直接保存され、コードベース同様に Git などのバージョン管理システム経由でチームメンバーと共有されます。
* ローカル限定（共有しない）ルールにする場合は、プロジェクトの `.gitignore` に `.qoder/rules` ディレクトリを追加してください。

<div id="limitations">
  ### **制限事項**
</div>

* **すべてのアクティブなルールファイル**の合計で**100,000文字**まで（超過分は切り捨てられます）。
* 自然言語のみ対応（画像やリンクは不可）。

<div id="rule-types">
  ## **ルールの種類**
</div>

| **タイプ**        | **説明**                                                   | **ユースケース**                            |
| :------------- | :------------------------------------------------------- | :------------------------------------ |
| Apply Manually | Chat パネルまたは Inline Chat で `@rule` を使って手動適用します。           | オンデマンドのワークフロー、カスタムプロンプト               |
| Model Decision | Agent Mode でルールの説明を AI が評価し、適用のタイミングを判断します。              | シナリオ特化のタスク（ユニットテストやコードコメントの生成など）      |
| Always Apply   | すべての Chat および Inline Chat のリクエストに適用します。                  | プロジェクト全体の標準（コーディングスタイルやドキュメント形式など）の徹底 |
| Specific Files | ワイルドカードパターン（`.js` や `src/**/.ts` など）に一致するすべてのファイルに適用します。 | プログラミング言語別・ディレクトリ別のルール                |

<div id="agents-md-compatibility">
  ## **AGENTS.md 互換性**
</div>

Qoder のルールは AGENTS.md ファイルとの互換性があります。この機能を有効にするには：

1. `AGENTS.md` ファイルをプロジェクトディレクトリにコピーするだけです
2. Agent が自動的にファイル内のルールを認識して活用します
3. 追加設定は不要 - シームレスに統合されます

> AGENTS.md コンテンツとルールコンテンツに競合がある場合、ルールコンテンツが優先されます。

<div id="best-practices">
  ## **ベストプラクティス**
</div>

* **簡潔に**: ルールは要点を絞り、曖昧さを避ける。
* **構造を明確に**: 可読性のために箇条書き、番号付きリスト、またはMarkdown記法を用いる。
* **例を示す**: モデルを導くために「良い」コードサンプルを提供する。
* **反復して最適化**: モデルの出力とフィードバックに基づいてルールを磨き上げる。

<div id="configure-rules">
  ## **ルールを設定する**
</div>

1. Qoder IDE の右上でユーザーアイコンをクリックするか、キーボードショートカット（`⌘` `⇧` `,`（macOS）または `Ctrl` `Shift` `,`（Windows））を使用し、**Qoder 設定** を選択します。
2. 左側のナビゲーションペインで **Rules** をクリックします。
3. **Add** をクリックします。
4. 上部の検索バーに一意のルール名を入力し、**Enter** を押します。
5. ルールタイプを選択します:
   * **Apply Manually**
   * **Model Decision**: シナリオの説明を入力します。
     * 例: 「Generate a unit test.」
   * **Specific Files**: カンマ区切りでファイルパスのワイルドカードを指定します。
     * 例: `*.md`, `src/*.java`
   * **Always Apply**
6. ウィンドウを閉じて変更を保存します。

<div id="next-steps">
  ## **次のステップ**
</div>

既存のルールを編集または削除するには、**Rules** ページで該当のアイコンをクリックします。