Configuration Overview

Loading model

Kompass loads configuration in this order:

For both the home directory and the project root, Kompass checks these file names in order:

Later layers replace or augment earlier configuration depending on the field.

Shared render-time guidance, including:

Controls command availability and template overrides.

Controls bundled agent definitions and enablement.

Controls built-in tool enablement and per-adapter tool name remapping.

Controls reusable template partials and path overrides used during command rendering.

Shared defaults such as baseBranch.

Adapter-specific configuration. Today this includes:

You can keep a Kompass tool enabled but expose it under a custom adapter-facing name:

{
  "tools": {
    "ticket_sync": {
      "enabled": true,
      "name": "custom_ticket_name"
    }
  }
}