From 9eb0b31b626abba36e6b23f5d7b7dd832620f3d7 Mon Sep 17 00:00:00 2001 From: dispatch-docs-bot Date: Thu, 12 Mar 2026 14:48:19 +0000 Subject: [PATCH] docs: auto-update from merge [docs-bot] Co-Authored-By: Claude --- CLAUDE.md | 1 + README.md | 12 ++++++++++++ 2 files changed, 13 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index 0b2f700..e18d025 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -18,6 +18,7 @@ Dispatch is a skill (`/dispatch`) for Claude Code that decomposes large coding t - **`.dispatch/` directory**: Ephemeral task state. Delete it to clean up. - **Config location**: `~/.dispatch/config.yaml` (auto-generated on first run). - **Skill source**: `skills/dispatch/SKILL.md` is the canonical skill definition. Do NOT modify it for docs changes. +- **Warm-up invocation**: Running `/dispatch` with no arguments (or just the word "dispatch") reads `~/.dispatch/config.yaml` and stops — it does not proceed to task planning. Used to pre-load config at session start. - **Multi-model resolution**: If multiple models are named in a single prompt, dispatch uses the last one mentioned. If no model is mentioned, dispatch confirms the default model with the user before proceeding. - **Failure recovery**: If a worker's model fails (auth error, quota, CLI unavailable), the user is prompted for an alternative and config is updated to avoid the same failure again. diff --git a/README.md b/README.md index ed5ab01..d351001 100644 --- a/README.md +++ b/README.md @@ -121,6 +121,18 @@ your session wrote five checklists and is idle. Dispatch more work or say "status" anytime. ``` +## Best practice: warm up at session start + +Run `/dispatch` with no arguments at the beginning of a session to pre-load your config: + +``` +/dispatch +``` + +This reads `~/.dispatch/config.yaml` into the dispatcher's context so subsequent dispatches are faster and don't need confirmation prompts. It's a good habit to add as a [Claude Code memory](https://docs.anthropic.com/en/docs/claude-code/memory) so you remember to do it each session: + +> "Run /dispatch at the start of each session to warm up the config." + ## Setup On first run, `/dispatch` auto-detects your CLIs (`claude`, `agent`, `codex`), discovers available models, and generates `~/.dispatch/config.yaml`. No manual config needed.