Tweak getting started docs

Author: jahooma

web/src/content/help/quick-start.mdx

@@ -27,7 +27,7 @@ cd /path/to/your-repo
 codebuff
 ```
 
-Codebuff has multiple [modes](/docs/tips/modes): `lite` for quick tasks, `max` for complex work, and `plan` for planning without file changes. You can invoke them in the slash menu with `/mode:`.
+Codebuff has multiple [modes](/docs/tips/modes): `plan` for planning without file changes, `max` for better results at higher cost and time. You can invoke them in the slash menu with `/mode`.
 
 ## 4. Initialize Your Project (Optional)
 
@@ -39,18 +39,13 @@ Run the `/init` command inside Codebuff to set up project-specific files:
 
 ### What `/init` Creates
 
-| File/Directory | Purpose |
-|---------------|----------|
-| `knowledge.md` | A starter file for documenting your project's setup commands, architecture, and coding conventions. Codebuff reads this to understand your project better. |
-| `.agents/types/` | TypeScript type definitions for creating custom agents. |
+- `knowledge.md` — A starter file for documenting your project's setup commands, architecture, and coding conventions. Codebuff reads this to understand your project better.
+- `.agents/types/` — TypeScript type definitions for creating custom agents.
 
 ### When to Use `/init`
 
-- **New projects** — Run `/init` once to create a `knowledge.md` file and get Codebuff familiar with your project.
-- **Building custom agents** — The `.agents/types/` directory provides TypeScript types for full IntelliSense when creating agents.
-- **Team onboarding** — Commit `knowledge.md` to your repo so Codebuff works consistently for all team members.
-
-> **Note:** `/init` is safe to run multiple times. It skips files that already exist and only creates missing ones.
+- **New projects** — if you don't already have an AGENTS.md or CLAUDE.md (Codebuff will also read these files).
+- **Building custom agents** — running /init is the first step to [creating your own agents](/docs/walkthroughs/creating-your-first-agent)!
 
 ## Troubleshooting