docs: Grok 4.6 chat ↔ Build workflow map

docs/FAQ.md

@@ -139,6 +139,10 @@ bash ~/GrokHunter/scripts/install_grok_statusline.sh
 # then restart grok
 ```
 
+## How should I split Grok chat vs Grok Build?
+
+See [GROK-46-WORKFLOW.md](GROK-46-WORKFLOW.md) — chat for think, Build for code, Bot for glue; V9 `/model` aliases all wrap `grok-4.6`.
+
 ## How do I check V9 model pickers / API key?
 
 ```bash

docs/GROK-46-WORKFLOW.md

@@ -0,0 +1,62 @@
+# Grok 4.6 chat ↔ Grok Build — workflow map
+
+How to route work across **Grok chat**, **Grok Bot**, and **Grok Build** so you
+do not thrash models or surfaces. Catalog id remains **`grok-4.6`**.
+
+See also: [GROK-46.md](GROK-46.md) · [GROK-BUILD-1.0.md](GROK-BUILD-1.0.md) · skill `grok-models`.
+
+## Surfaces
+
+| Surface | Best for | Model to pin |
+|---------|----------|--------------|
+| **Grok chat** (web/app) | Research, writing, quick Q&A, non-repo thinking | Grok 4.6 (chat UI selector) |
+| **Grok Bot** | Orchestration, connectors, PRs, multi-agent seating | Account default (Bot); not your main phone file editor |
+| **Grok Build** (`grok`) | Repo work, multi-file edits, long agent loops | Catalog default **`grok-4.6`** |
+| **Coding Team** (Benjamin → Lucas → Harper) | Design → ship → harden | Same `grok-4.6` via `~/.grok/agents/` |
+| **Aider** (`aider-grok`) | Focused diffs when the Build TUI is heavy | `AIDER_MODEL=grok-4.6` |
+
+## Grok Build `/model` pickers (V9)
+
+Install with `grokhunter models install` (or `bash scripts/install_v9_grok_models.sh`).
+All coding aliases wrap **`grok-4.6`** (4.5 names are legacy):
+
+| `/model` alias | Use when |
+|----------------|----------|
+| `chat-expert` / `grok-v9` | Hard reasoning, architecture, threat notes |
+| `multi` | Broader exploration / multi-angle |
+| `auto` | Everyday “pick something sensible” coding |
+| *(default, no switch)* | Normal pair-program / implement |
+
+**Imagine** stills/video stay on `grok-imagine-*` — do not use those for coding sessions.
+
+## Day-to-day routing
+
+1. **Decide / research** → Grok chat 4.6 (or Bot for “what should we do?”).
+2. **Plan a change** → `grok` + `/model chat-expert`, or `grokhunter plan "…"`.
+3. **Implement** → default `grok-4.6` (or Coding Team Lucas); keep turns small.
+4. **Harden / review** → Harper, or `/model chat-expert` on the diff.
+5. **Bot** → install, tunnels, GitHub, connectors — glue, not primary editor on phone.
+
+## Lab checklist (Termux / desktop)
+
+```bash
+grokhunter ensure
+grokhunter models status
+grokhunter models install          # if models=no or pickers missing
+bash scripts/install_grok_profile.sh --force   # if still on 4.5 / channel=alpha
+```
+
+In `grok`, confirm `/model` lists `chat-expert`, `multi`, `auto`, `grok-v9`, and the
+default coding model remains **`grok-4.6`**.
+
+## Success criteria
+
+- `grokhunter status` shows `models=yes` and profile on 4.6.
+- You know: chat for think, Build for code, Bot for glue.
+- Imagine models never selected for coding.
+
+## Related
+
+- [pair-programming](../skills/pair-programming/SKILL.md)
+- [CODING-TEAM.md](CODING-TEAM.md)
+- [FAQ.md](FAQ.md) — V9 pickers / API key

docs/GROK-46.md

@@ -86,6 +86,7 @@ All aliases wrap **grok-4.6**. Imagine stills/video stay on `grok-imagine-*`.
 
 ## Related
 
+- [Workflow map: chat ↔ Build](GROK-46-WORKFLOW.md)
 - [pair-programming skill](../skills/pair-programming/SKILL.md)
 - [EDITORS.md](EDITORS.md)
 - [X11-PERFORMANCE.md](X11-PERFORMANCE.md)