From 2e2785008cfe334cb3907fcf93eea6d851b76b93 Mon Sep 17 00:00:00 2001
From: Ogulcan Celik <ogulcancelik@gmail.com>
Date: Tue, 19 May 2026 16:34:17 +0300
Subject: docs: clarify herdr workflows and agent skill

---
 website/src/content/docs/index.mdx | 57 ++++----------------------------------
 1 file changed, 6 insertions(+), 51 deletions(-)

(limited to 'website/src/content/docs/index.mdx')

diff --git a/website/src/content/docs/index.mdx b/website/src/content/docs/index.mdx
index 9cdf9273..065145d1 100644
--- a/website/src/content/docs/index.mdx
+++ b/website/src/content/docs/index.mdx
@@ -23,31 +23,6 @@ curl -fsSL https://herdr.dev/install.sh | sh
 herdr
 ```
 
-## Core runtime
-
-<CardGrid>
-  <Card title="Detach and reattach">
-    Herdr runs panes in a background session server, so agents keep running after the UI client detaches.
-
-    [Use persistence →](/docs/persistence-remote/)
-  </Card>
-  <Card title="Attach over SSH">
-    Run Herdr where the code and credentials live. Attach from any SSH client or use `herdr --remote` from your local terminal.
-
-    [Use remote access →](/docs/persistence-remote/#remote-attach-over-ssh)
-  </Card>
-  <Card title="Real terminal panes">
-    Every pane is a real terminal. Split layouts, click panes, drag borders, select text, and use right-click menus.
-
-    [Learn concepts →](/docs/concepts/)
-  </Card>
-  <Card title="Runtime API">
-    See agent status in the sidebar and drive workspaces, tabs, panes, waits, and output reads through the CLI or socket API.
-
-    [Read the API guide →](/docs/socket-api/)
-  </Card>
-</CardGrid>
-
 ## Start here
 
 <CardGrid>
@@ -57,20 +32,15 @@ herdr
     [Install Herdr →](/docs/install/)
   </Card>
   <Card title="Quick start">
-    Create your first workspace, run agents in panes, split the layout, and detach safely.
+    Create your first workspace, run an agent, split panes, and detach safely.
 
     [Start using Herdr →](/docs/quick-start/)
   </Card>
-  <Card title="Concepts">
-    Understand workspaces, tabs, panes, agents, sessions, modes, and state rollups.
+  <Card title="Local, SSH, and mobile">
+    Run Herdr locally, inside SSH, from your phone, or through `herdr --remote`.
 
-    [Learn the model →](/docs/concepts/)
+    [Pick a workflow →](/docs/how-to-work/)
   </Card>
-</CardGrid>
-
-## Guides and reference
-
-<CardGrid>
   <Card title="Agents">
     See supported agents, detection behavior, integrations, custom labels, and direct attach.
 
@@ -81,24 +51,9 @@ herdr
 
     [Configure Herdr →](/docs/configuration/)
   </Card>
-  <Card title="Integrations">
-    Install agent integrations for Pi, Claude Code, Codex, and OpenCode.
-
-    [Set up integrations →](/docs/integrations/)
-  </Card>
-  <Card title="CLI reference">
-    Use every Herdr command for sessions, workspaces, tabs, panes, agents, waits, and integrations.
-
-    [Browse commands →](/docs/cli-reference/)
-  </Card>
-  <Card title="Socket API">
-    Control Herdr from scripts, tools, and agents through the local socket API.
+  <Card title="API">
+    Control Herdr from scripts, tools, and agents through the CLI and local socket API.
 
     [Read the API guide →](/docs/socket-api/)
   </Card>
-  <Card title="Agent skill">
-    Teach an agent running inside Herdr how to create panes, read output, and wait for neighboring agents.
-
-    [Use the skill →](/docs/agent-skill/)
-  </Card>
 </CardGrid>
-- 
cgit v1.2.3