docs: update models page, add AGENTS.md/CLAUDE.md support, move modes to getting started, standardize discord links

Author: brandonkachen

web/src/components/footer.tsx

@@ -30,7 +30,7 @@ const communityLinks: LinkInfo[] = [
     href: 'https://github.com/CodebuffAI/codebuff',
     target: '_blank',
   },
-  { text: 'Discord', href: 'https://discord.gg/mcWTGjgTj3', target: '_blank' },
+  { text: 'Discord', href: 'https://codebuff.com/discord', target: '_blank' },
 ]
 
 const authLinks: LinkInfo[] = [{ text: 'Login', href: '/login' }]

web/src/content/advanced/config.mdx

@@ -72,4 +72,4 @@ If your startup processes aren't working as expected:
 3. Check the process output in the specified log files if you've configured them
 4. Make sure the JSON syntax in your configuration file is valid
 
-Need more help? Check [Troubleshooting](/docs/advanced#troubleshooting) or join [Discord](https://discord.gg/mcWTGjgTj3).
+Need more help? Check [Troubleshooting](/docs/advanced#troubleshooting) or join [Discord](https://codebuff.com/discord).

web/src/content/advanced/what-models.mdx

@@ -7,12 +7,32 @@ order: 3
 
 # What models do you use?
 
-We pick models by task:
+Codebuff runs an orchestrator agent that spawns specialized subagents. Each subagent uses a model suited to its task.
 
-- **Claude Opus 4.5** - Primary model for default and max modes
-- **Grok 4.1 Fast** - Used in lite mode for speed
-- **GPT-5** - Used for certain editing tasks
-- **Gemini 2.5 Pro/Flash** - File discovery and thinking tasks
-- **Relace AI** - Speculative decoding for fast file rewrites
+## Orchestrator
 
-See [Modes](/docs/tips#modes) for how each mode uses different model configurations.
+The main agent ("Buffy") coordinates everything:
+
+| Mode | Model |
+|------|-------|
+| Default | Claude Opus 4.5 |
+| Max | Claude Opus 4.5 |
+| Lite | Grok 4.1 Fast |
+
+## Subagents
+
+The orchestrator spawns these for specific jobs:
+
+| Task | Models |
+|------|--------|
+| Code editing | Claude Opus 4.5, GPT-5.1 |
+| Thinking/reasoning | Claude Opus 4.5, GPT-5.1, Gemini 2.5 Pro |
+| Code review | Claude Sonnet 4.5, GPT-5.1 |
+| File discovery | Gemini 2.0 Flash, Grok 4 Fast |
+| Terminal commands | Claude Haiku 4.5 |
+| Context management | GPT-5 Mini |
+| Web/docs research | Grok 4 Fast |
+
+Max mode runs multiple implementations in parallel and picks the best one. Default mode runs a single implementation pass. Lite mode skips validation steps for speed.
+
+File rewrites use speculative decoding from Relace AI.

web/src/content/case-studies/_cta.mdx

@@ -1,3 +1,3 @@
 # More on the Way
 
-More stories are coming. Want to share yours? Ping us on [Discord](https://discord.gg/mcWTGjgTj3) or email [founders@codebuff.com](mailto:founders@codebuff.com).
+More stories are coming. Want to share yours? Ping us on [Discord](https://codebuff.com/discord) or email [founders@codebuff.com](mailto:founders@codebuff.com).

web/src/content/help/faq.mdx

@@ -27,7 +27,7 @@ codebuff --create minecraft-simple
 
 ## What model does Codebuff use?
 
-Multiple models: Claude Opus 4.5 and Claude Sonnet 4.5 for most coding, GPT-5 for quick edits, Gemini 2.5 Pro/Flash for discovery and thinking tasks, plus speculative decoding from Relace AI for faster file rewrites.
+Multiple. The orchestrator uses Claude Opus 4.5 (or Grok 4.1 Fast in lite mode). Subagents use GPT-5.1 for editing and thinking, Gemini 2.0/2.5 for file discovery and reasoning, Claude Haiku 4.5 for terminal commands, and Relace AI for fast file rewrites. See [What models do you use?](/docs/advanced#what-models-do-you-use) for the full breakdown.
 
 ## Do you store my data?
 
@@ -43,7 +43,7 @@ If you want isolation, use the [Dockerfile](https://github.com/CodebuffAI/codebu
 
 ## Can I specify custom instructions for Codebuff?
 
-Yes. Add `knowledge.md` files to describe patterns, constraints, and commands. Files ending in `knowledge.md` load automatically. Codebuff updates existing ones but won't create them unless you ask.
+Yes. Add `knowledge.md` files to describe patterns, constraints, and commands. Codebuff also reads `AGENTS.md` and `CLAUDE.md` if present. Per directory, it picks one: `knowledge.md` first, then `AGENTS.md`, then `CLAUDE.md`. Codebuff updates existing knowledge files but won't create them unless you ask.
 
 ## Can I tell Codebuff to ignore certain files?
 
@@ -86,6 +86,6 @@ See [Codebuff vs Claude Code](/docs/advanced#codebuff-vs-claude-code) for a deta
 
 ## I have more questions!
 
-Contact [support@codebuff.com](mailto:support@codebuff.com) or [join our Discord](https://discord.gg/mcWTGjgTj3).
+Contact [support@codebuff.com](mailto:support@codebuff.com) or [join our Discord](https://codebuff.com/discord).
 
 Having technical issues? Check out our [Troubleshooting](/docs/advanced#troubleshooting) guide for solutions to common problems.

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

@@ -25,6 +25,8 @@ Run Codebuff in your project directory:
   codebuff
 ```
 
+Codebuff has multiple [modes](/docs/help#modes): `--lite` for quick tasks, `--max` for complex work, and `--plan` for planning without file changes.
+
 ## Troubleshooting Install
 
 If you run into issues during installation:

web/src/content/tips/best-practices.mdx

@@ -19,7 +19,9 @@ Codebuff skips files in `.gitignore`. For files you keep in git but want Codebuf
 
 ## Planning
 
-Codebuff can outline work before editing. Drop a rough description of the feature, then ask it to turn that into a plan in `plan.md`. Review and adjust the plan, then point Codebuff at it when you start coding.
+Use `--plan` mode to scope work before implementing. Codebuff gathers context, asks clarifying questions, and outputs a structured plan without touching files. Review and adjust the plan, then switch to default or max mode to execute.
+
+See [Modes](/docs/help#modes) for details on plan mode and other options.
 
 ## Include docs by link
 

web/src/content/tips/keyboard-shortcuts.mdx

@@ -24,7 +24,7 @@ Commands inside Codebuff:
 - `--max`: more context for hard work
 - `--plan`: plan only, no file changes
 
-See [Modes](/docs/tips#modes) for details on each mode.
+See [Modes](/docs/help#modes) for details on each mode.
 
 ## Terminal commands
 

web/src/content/tips/modes.mdx

@@ -1,8 +1,8 @@
 ---
 title: 'Modes'
-section: 'tips'
+section: 'help'
 tags: ['modes', 'lite', 'max', 'plan', 'configuration']
-order: 1
+order: 2
 ---
 
 # Modes