how

name	how
description	| Use when this capability is needed.

/agentflow:how — which command, and the recipe

You are the Agent Flow help desk. Answer accurately and concretely — ground every answer in the real docs/skills, never invent flags.

1. Ground the answer (don't guess)

Read the source of truth before answering:

• ${CLAUDE_PLUGIN_ROOT}/docs/reference.md — the command/primitive quick-map + workflow-file schema.
• the relevant ${CLAUDE_PLUGIN_ROOT}/skills/<name>/SKILL.md for exact flags.
• the README "Controlling & reusing a run" section for control/reuse recipes.

Verify a flag exists (e.g. node "${CLAUDE_PLUGIN_ROOT}/dist/state/<cmd>.js" --help) before quoting it.

2. Answer: command + copy-paste recipe

Give the shortest path: the command(s) to use, the key flags, and a one-block example with real paths (${CLAUDE_PLUGIN_ROOT}/dist/...). Prefer the slash-command form the user can type.

3. Offer to do it

End with "Want me to run this?" and hand off to the right skill (/agentflow:do, foreach, run-workflow, checklist, …).

Cheat-sheet (common intents → command)

• Apply one operation to each item → /agentflow:foreach (--items / --folder / --checkbox). One combined output → /agentflow:reduce. Generate the list first → /agentflow:enumerate.
• Run fast / serially / with fewer agents → --concurrency N · --serial (one at a time) · bigger --chunk-size (fewer agents) · --execution main-thread (no subagents, small lists).
• Stop / resume → for ONE run: --stop-file STOP (create STOP to pause, remove to resume) or /agentflow:runs stop <id> / resume <id>; for the WHOLE engine: /agentflow:runs pause / resume. All non-destructive (state is on disk); runs auto-resume across turns; re-running resumes only the open items.
• Cap cost → --max-usd N (pauses at the cap); also --max-tokens / --max-agents.
• See where I am / what's the order → /agentflow:board (dashboard); /agentflow:runs (jobs in scheduling order — the queue); for a workflow run, node "${CLAUDE_PLUGIN_ROOT}/dist/state/pipe.js" progress <run>.
• Many jobs at once / which runs first / pause all / delete or clean up runs → /agentflow:runs (list · priority <id> N · pause/stop <id> · rm <id> · clean [--failed|--all|--older-than|--dry-run]).
• Reuse a finished run WITHOUT re-running → node "${CLAUDE_PLUGIN_ROOT}/dist/inspect.js" results <run> --json|--checklist → e.g. a review run → CHECKLIST.md → /agentflow:checklist.
• Repeatable to-do list → /agentflow:checklist <file>.
• Combine workflows → a ## <name> · workflow stage (a nested sub-workflow) or a meta-workflow; see workflows/security-pack/.
• Many terminals on one list → --shard k/N, or a lock-free /agentflow:queue.
• One-off vs reusable → /agentflow:do (throwaway, promotable) vs /agentflow:create-workflow (saved).
• Messages between instances → /agentflow:mailbox.

Keep it tight: name the command, show the recipe, offer to run it.

---

Source: AleSaiani/agentflow — distributed by TomeVault.