mirror of
https://github.com/runbear-io/beardrive.git
synced 2026-08-25 08:08:08 +02:00
The sidebar and the homepage disagreed. index.md's "Where to start" already led with connecting an agent, but the left rail read Install (brew) -> Quickstart (bdrive login, bdrive init) -> ... -> Connect an agent, three groups down. Anyone following the rail met the CLI first and the skill last — the opposite of how the product is meant to be adopted. The agent page was also filed under guides/, which this repo defines as agent-workflow docs rather than setup. Sidebar order is now the recommended path, and that path is agent-first: Start here what it is -> set up with your agent -> your first hour Working with agents shared memory, artifacts, read heat, scoping Manual setup (opt) install the CLI, set up by hand, skills and hooks Self-hosting / Reference / Concepts unchanged - start/setup (was guides/connect-an-agent): rewritten as the front door. Claude Code's plugin, then the one-paste for Codex/Gemini/Hermes, then what the agent just installed and how to check it. - start/first-hour (new): the page that was missing — ask for a doc, get a link back, share it, a teammate's agent picks it up. What success looks like without a command you have to type. - manual/skills-and-hooks (new): the mechanics lifted out of the old onboarding page — per-platform paths, hook events, idempotency, project-level vs per-user — so the Start page can stay conversational. - manual/install and manual/setup-by-hand (were start/*): both now open by saying you probably don't need them, and link back to the agent path. - index.md leads with "You don't install it — you ask your agent to"; the CLI and hub sentence moves below it. No `brew install` appears anywhere in Start here. Reference -> CLI stays exactly where it was: the people most likely to self-host are CLI-first, and burying it would read as condescending. Three public URLs moved, so astro.config.mjs declares redirects. Static builds emit meta-refresh only, so README carries copy-paste 301 rules for the host — Firebase Hosting and a Cloud Storage + load balancer URL map. Verified: 18 pages build, zero broken internal links across the built output, all three redirects resolve. CLAUDE.md and the docs README record the rule so this doesn't quietly revert. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>