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

# コンセプト

> Kodus CLI を最大限に活用するためのメンタルモデル。

CLI のあらゆる場所に登場するアイデアの簡単なツアーです。一度読めば、残りのドキュメントがより理解しやすくなります。

## 差分モード

すべてのレビューは1つの質問に答える必要があります: *何が変わったか?* CLI は4つの差分モードをサポートしており、それぞれ異なる情報源を持ちます。

| モード                         | 差分のソース                 | ファイルをインライン化? | 使用タイミング                        |
| --------------------------- | ---------------------- | ------------ | ------------------------------ |
| **作業ツリー**（デフォルト）            | 作業ディレクトリ内のコミットされていない変更 | はい           | 開発中、ステージング前。                   |
| **ステージ済み**（`--staged`）      | `git diff --cached`    | はい           | コミット直前 — `git commit` と同じスコープ。 |
| **ブランチ**（`--branch <base>`） | `base..HEAD` のコミット済み差分 | いいえ          | ブランチ全体のマージ前レビュー。               |
| **コミット**（`--commit <sha>`）  | 単一コミットによって導入された差分      | いいえ          | 1つのコミットの監査、チェリーピックレビュー。        |

<Tip>
  **インライン化が重要な理由は?** 作業ツリーとステージ済みレビューは、バックエンドがコミットされていない作業を確認できないため、差分と一緒にファイルの内容を送信します。ブランチとコミットモードはインライン化をスキップします — バックエンドは同じコミットを直接クローンします。そのため、ブランチ/コミットレビューは、作業ツリーレビューがリクエストサイズ制限を超えてしまうような巨大な差分でも機能します。
</Tip>

## レビューモード

3つの出力スタイル、同じ基本的なレビュー。

* **インタラクティブ**（デフォルト）— ファイルを一覧表示し、問題を展開し、プレビューで1つずつ修正を適用する TUI。ターミナルで作業する自然な方法。
* **自動修正**（`--fix`）— 単一の確認で、修正可能な問題を全て一度に適用します。ルールを信頼してバッチ適用したい場合に使用。
* **プロンプトのみ**（`--prompt-only`）— AIエージェントが解析して行動するために設計された最小限の構造化テキスト。エージェントループで `--fail-on` と組み合わせて、レビューがクリーンになったときにループがきれいに終了するようにします。

非インタラクティブなコンシューマー（CI、スクリプト、ウェブフック）には、任意のコマンドで `--format json` または `--format markdown` も使用できます。

## 認証モード

マシンごとに1つ選択します。CLI は利用可能なものを自動検出します。

* **トライアル** — 認証なし。1日5回のレビュー。「一度試す」のに最適。
* **個人ログイン**（`kodus auth login`）— 個人アカウント。トークンは自動更新。
* **チームキー**（`kodus auth team-key --key kodus_xxxxx`）— ダッシュボードで生成される、チーム用の共有キー。AIエージェントやインタラクティブなログインを避けたい場所に推奨。
* **CI/CD トークン**（`kodus auth token`）— パイプライン用の長期トークン。ログイン済みのマシンから生成し、`KODUS_TOKEN` 経由で使用。

詳細な決定ツリーは [はじめに](getting_started) を参照してください。

## Kody Rules

**Kody Rule** は、Kodus レビュアーがすべてのレビュー中に適用する構造化ルールで、リポジトリにスコープされるかチームにグローバルに適用されます。

```
Rule
├── title          "No console.log in production code"
├── rule           "Avoid leaving console.log in committed code"
├── severity       low | medium | high | critical
├── scope          file | pull request
├── path           **/*.ts       (ファイルターゲティングのグロブ)
└── repo-id        <uuid> | global
```

ルールは一般的な Kodus レビューの上に重なります — AIはそれらを代替品ではなく追加基準として使用します。

ルールはダッシュボードから、または `kodus rules create|update|view` を使って CLI から管理します。CLI はルールをバージョン管理に置きたい場合（スクリプトから生成し、リポジトリにチェックインし、プロビジョニング時に再適用する）に便利です。

## リポジトリ設定

Kodus の各リポジトリには、レビューの動作を管理する設定があります: 無視するファイル、ベースブランチのパターン、タイトルフィルター、機能トグル。これらは Kodus バックエンドに存在し、リポジトリがレビューされる場所（ウェブ PR、CLI レビュー、エージェントループ）でミラーリングされます。

CLI から:

```bash theme={null}
kodus config repo list                 # 設定されたリポジトリを確認
kodus config repo show                 # 現在のリポジトリの設定を確認
kodus config repo setup                # ガイド付きウィザード
kodus config repo set . reviewEnabled true
kodus config repo add-ignore-file . "**/*.generated.ts"
kodus config repo open                 # ウェブダッシュボードにジャンプ
```

`kodus config repo` と `kodus config remote` は同じコマンドグループのエイリアスです。

## 集中管理設定

通常、各リポジトリの設定は Kodus に存在します。**集中管理設定**を使用すると、チームはそれらの設定を単一の信頼できるソース git リポジトリに保存できます — すべての変更がそのリポジトリへのプルリクエストになり、レビュー設定自体のレビューとバージョン履歴が得られます。

有効化、同期、または状態の確認:

```bash theme={null}
kodus config centralized status
kodus config centralized init owner/config-repo --sync-option pr
kodus config centralized sync
kodus config centralized disable
```

チームがレビュー設定の監査可能なバージョン管理を望む場合は集中管理設定を使用します。その手間が過剰な場合はデフォルト（Kodus 内のリポジトリごとの設定）を維持します。

## Decision Memory

Decision Memory は、AIエージェントの作業の背後にある*推論*を永続化する Kodus の方法です — 差分だけでなく「なぜ」も。

有効にすると、Kodus は Claude Code、Cursor、または Codex に、ターン完了イベントごとに発火して構造化された決定をキャプチャするフックをインストールします:

```
.kody/
├── pr/by-sha/<head-sha>.md    # PR レベルの決定（コードとともにバージョン管理）
├── memory/<module-id>.md      # モジュールレベルの決定（長期）
└── modules.yml                # モジュール設定
```

PR レベルのメモリはブランチに存在します。PR がマージされたら、その決定をモジュールレベルのメモリに昇格させます（`kodus decisions promote`）。これにより、そのモジュールの将来の作業が蓄積されたコンテキストから始まります。

完全なウォークスルー: [Decision Memory](decision_memory)。

## ビジネス検証

`kodus review` が「このコードは良いか?」を問うのに対し、`kodus pr business-validation` は「この差分は実際にタスクが指示したことを行っているか?」を問います。Linear/Jira/URL ベースのタスクと差分ソース（作業ツリー、ステージ済み、ブランチ、コミット）を指定すると、タスクの受け入れ基準に対して実装をチェックします。

```bash theme={null}
kodus pr business-validation --task-id KC-1441 --branch main
kodus pr business-validation --task-url https://linear.app/… --staged
```

人間のレビュー前に「コードは動作するが、要求されたものではない」を検出するためのマージ前チェックと組み合わせます。

## AI エージェント出力（`--prompt-only` と `--agent`）

2つの関連するフラグ、異なる役割。

* **`--prompt-only`** — 出力は AI エージェントが解析して行動するために最適化されています。レビュースタイルの出力を生成するコマンド（`review`、`pr suggestions`）にのみ機能します。
* **`--agent`** — 任意のコマンドで**決定論的な機械可読**出力を強制するグローバルフラグ。スクリプトやエージェントが CLI 出力を解析する場合に使用し、厳密なフォーマット要件には `--format json` と組み合わせます。

ほとんどのエージェント統合では `--prompt-only` だけで十分です。ハーネスやツール呼び出しループから CLI を操作する場合に `--agent` を使用します。

## 次のステップ

<CardGroup cols={2}>
  <Card title="コマンドリファレンス" icon="book" href="commands">
    完全なコマンド + フラグ一覧。
  </Card>

  <Card title="AI エージェント" icon="robot" href="ai_agents">
    コーディングエージェントとのレビュー・修正ループを構築。
  </Card>

  <Card title="Decision Memory" icon="brain" href="decision_memory">
    ブランチをまたいでエージェントの決定をキャプチャして昇格。
  </Card>

  <Card title="トラブルシューティング" icon="life-ring" href="troubleshooting">
    一般的なエラーと終了コード。
  </Card>
</CardGroup>