docs: add comprehensive documentation for AI agents, chezmoi workflow, shell setup, desktop configuration, terminal multiplexers, and developer tools

docs/index.mdx

@@ -0,0 +1,53 @@
+---
+title: dots
+description: prdlk's dotfiles, managed with chezmoi. One command installs chezmoi and applies the whole setup.
+sidebar:
+  label: Overview
+  icon: house
+---
+
+```sh
+curl -fsSL https://dots.prd.lk/install | sh
+```
+
+That command installs chezmoi to `~/.local/bin`, clones [prdlk/dotfiles](https://github.com/prdlk/dotfiles), asks three questions (name, email, machine role), installs packages, and applies every config. See [Installation](/installation) for the options, prerequisites, and the private-repo auth step.
+
+## What's managed
+
+<CardGroup cols={2}>
+  <Card title="How it works" href="/chezmoi" icon="settings">
+    chezmoi layout, machine roles, symlink mode, age encryption, package manifests, apply scripts, and externals.
+  </Card>
+  <Card title="Shell" href="/shell" icon="terminal">
+    fish, bash, and zsh with shared aliases, starship, atuin, and the `~/.local/bin` scripts.
+  </Card>
+  <Card title="Terminal" href="/terminal" icon="square-terminal">
+    kitty, ghostty, tmux, and herdr.
+  </Card>
+  <Card title="Tools" href="/tools" icon="wrench">
+    git, gh and gh-dash, neovim, yazi, lazygit, lazydocker, bat, topgrade, hunk, and more.
+  </Card>
+  <Card title="Desktop" href="/desktop" icon="monitor">
+    niri with noctalia, Hyprland with the omarchy helpers, waybar, fonts, and default apps.
+  </Card>
+  <Card title="AI agents" href="/ai" icon="bot">
+    Claude Code, omp, and the shared agent skill library.
+  </Card>
+</CardGroup>
+
+## Machine roles
+
+The first apply asks for a role. It controls which parts of the repo land on the machine.
+
+| Role | Platform | Gets |
+| --- | --- | --- |
+| `desktop` | Arch Linux | Everything: universal toolset plus the Linux desktop layer |
+| `laptop` | Arch Linux | Same as `desktop` |
+| `mac` | macOS | Universal toolset via Homebrew; no Linux desktop layer |
+| `server` | Any | Universal toolset only |
+
+The default is `mac` on macOS and `desktop` everywhere else. See [Configuration](/chezmoi/config) and [Ignore rules](/chezmoi/externals-and-ignore).
+
+## Theme
+
+The shared palette is **cyberdream**. bat, atuin, and yazi select it. fish and omp ship a cyberdream theme but do not select it. kitty takes its colors from the active Omarchy theme. The noctalia, koda, and ii-auto variants are shipped for ghostty, kitty, and yazi. The font is **Victor Mono Nerd Font**.