diff --git a/docs/FAQ.md b/docs/FAQ.md index 0c056c0..0adca8c 100644 --- a/docs/FAQ.md +++ b/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 diff --git a/docs/GROK-46-WORKFLOW.md b/docs/GROK-46-WORKFLOW.md new file mode 100644 index 0000000..3bcb4e9 --- /dev/null +++ b/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 diff --git a/docs/GROK-46.md b/docs/GROK-46.md index 12a631c..f81696f 100644 --- a/docs/GROK-46.md +++ b/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)