Consolidate installation docs and add prerequisites

README.md

@@ -23,6 +23,10 @@ Kompass keeps AI coding agents on course with token-efficient, composable workfl
 - Structured tools keep workflows grounded in repo and GitHub state: `changes_load`, `command_expansion` (resolve a slash command and return the expanded prompt for immediate delegation), `pr_load`, `pr_sync`, `ticket_load`, `ticket_sync`.
 - Reusable command-template components live in `packages/core/components/` and are documented in the components reference.
 
+## Prerequisites
+
+- **GitHub CLI** (`gh`) must be installed and authenticated. Kompass uses `gh` for all GitHub operations (PRs, issues, reviews). Install from [cli.github.com](https://cli.github.com/) and run `gh auth login`.
+
 ## Installation
 
 For OpenCode, add the adapter package to your config:

packages/web/astro.config.mjs

@@ -8,14 +8,18 @@ export default defineConfig({
       title: "Kompass Docs",
       description: "Guided workflows for AI coding agents.",
       favicon: "/kompass-icon.png",
+      logo: {
+        src: "./public/kompass-icon.png",
+        alt: "Kompass",
+        replacesTitle: false
+      },
       social: {
         github: "https://github.com/kompassdev/kompass"
       },
       customCss: ["./src/styles/starlight.css"],
       sidebar: [
         "docs",
         "docs/getting-started",
-        "docs/installation",
         {
           label: "Concepts",
           items: ["docs/concepts/modes", "docs/concepts/architecture"]

packages/web/src/content/docs/docs/getting-started.mdx

@@ -3,6 +3,10 @@ title: Getting Started
 description: Install Kompass for OpenCode and start using the bundled workflow system.
 ---
 
+## Prerequisites
+
+- **GitHub CLI** (`gh`) must be installed and authenticated. Kompass uses `gh` for all GitHub operations (PRs, issues, reviews). Install from [cli.github.com](https://cli.github.com/) and run `gh auth login`.
+
 ## Quick start
 
 Kompass currently ships an OpenCode adapter package: `@kompassdev/opencode`.
@@ -15,7 +19,7 @@ Add it to your OpenCode config:
 }
 ```
 
-## Add optional project config
+## Optional project config
 
 If you want to customize commands, agents, tools, or defaults for a project, add one project override file.
 
@@ -34,6 +38,15 @@ To start from the published base config:
 curl -fsSL https://raw.githubusercontent.com/kompassdev/kompass/main/kompass.jsonc -o .opencode/kompass.jsonc
 ```
 
+### What the override can control
+
+- shared validation guidance
+- enabled commands and custom templates
+- agent enablement and prompt overrides
+- tool enablement and tool-name remapping
+- component path overrides
+- default base branch and adapter settings
+
 ## Start using workflows
 
 Once the plugin is installed, you can use commands such as:
@@ -59,6 +72,11 @@ opencode export <sessionID>
 - shared workflow logic stays in the Kompass package rather than your project repo
 - project overrides are layered on top of the bundled base config
 
+## Current adapter support
+
+- **OpenCode**: supported now
+- **Claude Code**: planned, not shipped yet
+
 ## Next steps
 
 - Read [`OpenCode`](/docs/adapters/opencode/) for adapter-specific behavior.

packages/web/src/content/docs/docs/index.mdx

@@ -24,8 +24,7 @@ Kompass is a shared workflow toolkit for AI coding agents.
 
 ## What to read next
 
-- Start with [`Getting Started`](/docs/getting-started/) for the fastest path.
-- Use [`Installation`](/docs/installation/) for config setup and override locations.
+- Start with [`Getting Started`](/docs/getting-started/) for installation and first steps.
 - See [`OpenCode`](/docs/adapters/opencode/) for the current supported adapter.
 - Use [`Commands`](/docs/reference/commands/) and [`Tools`](/docs/reference/tools/) as the main reference.
 - See [`Workspace Development`](/docs/workspace/development/) if you are contributing to this repo.