docs: refines documentation

Updates documentation to reflect current features and improve clarity.

Specifically:
- Adds `protocol` field to agent config documentation.
- Removes outdated information about planned AI CLI integrations.
- Clarifies the purpose of MCP tools.
- Excludes CNAME and CHANGELOG.md from pre-commit checks.

Author: aorumbayev

.pre-commit-config.yaml

@@ -4,7 +4,7 @@ repos:
     rev: v6.0.0
     hooks:
       - id: end-of-file-fixer
-        exclude: ^tests/__snapshots__/
+        exclude: ^(tests/__snapshots__/|CNAME$)
       - id: trailing-whitespace
         exclude: ^tests/__snapshots__/
       - id: check-yaml
@@ -19,7 +19,7 @@ repos:
     rev: 1.0.0
     hooks:
       - id: mdformat
-        exclude: ^(\.github/|README\.md$)
+        exclude: ^(\.github/|README\.md$|CNAME$|CHANGELOG\.md$)
         additional_dependencies:
           - mdformat-gfm
           - mdformat-ruff

docs/config.md

@@ -50,14 +50,15 @@ active = true
 "*" = "claude"
 ```
 
-| Field                 | Purpose               |
-| --------------------- | --------------------- |
-| `identity`            | Unique agent ID       |
-| `name`                | Display name          |
-| `short_name`          | Compact label         |
-| `active`              | Enable agent          |
-| `run_command`         | AUTO mode ACP command |
-| `interactive_command` | PAIR mode CLI command |
+| Field                 | Purpose                      |
+| --------------------- | ---------------------------- |
+| `identity`            | Unique agent ID              |
+| `name`                | Display name                 |
+| `short_name`          | Compact label                |
+| `protocol`            | Protocol type (default: acp) |
+| `active`              | Enable agent                 |
+| `run_command`         | AUTO mode ACP command        |
+| `interactive_command` | PAIR mode CLI command        |
 
 ### Multiple agents
 

docs/index.md

@@ -15,17 +15,9 @@ uv run kagan
 
 ## Supported AI CLIs
 
-Available now:
-
 - Claude Code
 - OpenCode
 
-Coming soon:
-
-- Gemini
-- Codex
-- More providers
-
 ## Key bindings (cheat sheet)
 
 ### Navigation

docs/user-guide.md

@@ -13,17 +13,9 @@ Kagan is a keyboard-first Kanban TUI for AI-assisted development.
 
 ## Supported AI CLIs
 
-Available now:
-
 - Claude Code
 - OpenCode
 
-Coming soon:
-
-- Gemini
-- Codex
-- More providers
-
 ## Install & run
 
 ```bash
@@ -135,11 +127,11 @@ Press `p`, describe a goal, approve or refine the proposed tickets.
 
 ## MCP tools
 
-| Tool                                    | Purpose                              |
-| --------------------------------------- | ------------------------------------ |
-| `get_context(ticket_id)`                | Ticket context + acceptance criteria |
-| `update_scratchpad(ticket_id, content)` | Append notes                         |
-| `request_review(ticket_id, summary)`    | Move to REVIEW                       |
+| Tool                                    | Purpose                                                                              |
+| --------------------------------------- | ------------------------------------------------------------------------------------ |
+| `get_context(ticket_id)`                | Get ticket context including title, description, acceptance criteria, and scratchpad |
+| `update_scratchpad(ticket_id, content)` | Append notes to ticket scratchpad                                                    |
+| `request_review(ticket_id, summary)`    | Move PAIR ticket to REVIEW (requires all changes to be committed)                    |
 
 Run server: