# Alesaiani Agentflow How

> Alesaiani Agentflow How

- Skill: `tomevault-io/alesaiani-agentflow-how` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/alesaiani-agentflow-how`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/alesaiani-agentflow-how/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/alesaiani-agentflow-how

---


# /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](https://github.com/AleSaiani/agentflow) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-15 -->