構成の適用範囲

​

概要

構成項目の階層的なマージ方法や適用順序については、設定ファイルと適用順序を参照してください。

​

個人設定

• UIテーマ、ステータスバー、ショートカットキーなどのUI環境設定。
• 個人がデフォルトで使用するモデルと推論エフォート。
• 自動アップグレードなどの個人レベルのスイッチ。

​

プロジェクト構成

• 権限ルールとディレクトリ信頼ポリシー。
• プロジェクトで統一するモデル選択やパラメータ。
• プロジェクトレベルの拡張設定（MCP、フックなど）。

​

ローカル構成

• ローカルサービスアドレス、個人のテストデータ。
• プロジェクト構成に対する個人の一時的なオーバーライド。

​

.qoder ディレクトリ構造

<プロジェクト>/.qoder/
├── settings.json          # プロジェクトレベルの設定（コミット可能）
├── settings.local.json    # ローカルプロジェクト設定（コミット対象外）
├── rules/                 # プロジェクトレベルのルールファイル（*.md）
├── skills/                # プロジェクトレベルのSkills
├── worktrees/             # --worktree で作成された隔離ワークツリー
└── scheduled_tasks.json   # 定期タスクの定義

• rules/ にはトピックごとに分割されたルールファイルが格納されます。メモリを参照してください。
• skills/ にはプロジェクトレベルスキルが格納されます。スキルを参照してください。
• worktrees/ には --worktree によって作成された隔離チェックアウトが格納されます。タスクの実行およびタスクの並列処理を参照してください。
• scheduled_tasks.json にはスケジュールタスクが保存されます。定期実行タスクを参照してください。

ユーザー構成ディレクトリの場所は、QODER_CONFIG_DIR 環境変数でカスタマイズできます。プロジェクトレベルの .qoder ディレクトリは、常にプロジェクトルートディレクトリに配置されます。

​

選択ガイド

1. これはすべてのプロジェクトにまたがる個人の環境設定か？ → 個人設定に配置します。
2. これはチームで統一すべきプロジェクトの規約か？ → プロジェクト構成に配置し、リポジトリにコミットします。
3. これは自分のマシン専用で、他のメンバーに影響を与えたくないプロジェクト設定か？ → ローカル構成に配置し、.gitignore に追加します。