| name | repeat |
| user-invocable | false |
| description | Run a stage a FIXED number of times — a bounded count loop (`for i in 1..N`). One iteration per turn; the Stop hook resumes the next across turns. For a loop with a semantic stop condition, use `/agentflow:until` (do…until) or `/agentflow:while` (while…do) instead.
USE when the user says "do X N times", "run the suite 5 times", "retry 3 times", "regenerate twice".
|
| allowed-tools | Bash, Read, Agent |
| argument-hint | --times N --stage "<bash command>" |
/agentflow:repeat — fixed-count loop
Make it visible: the moment you start, say so in one line (skill + run-id) so it's clear an Agent Flow
run is happening; /agentflow:board then lists every run on disk — the audit trail.
Engine: iterate (runs show as cmd: iterate in /agentflow:inspect). A repeat is an iterate with a
never-satisfied predicate, so it terminates only at --times.
Init
node "${CLAUDE_PLUGIN_ROOT}/dist/state/iterate.js" init <run-id> \
--stage "<command to run each time>" \
--times <N>
(--stage takes a plain bash command; pass a JSON object only if you need extra fields.)
Drive (one iteration per turn)
node "${CLAUDE_PLUGIN_ROOT}/dist/state/iterate.js" run-iteration <run-id>
Inspect the JSON: action: "continue" → end the turn (the Stop hook fires again next turn);
action: "stop" with reason: "max_iterations" → the N runs are done, surface the result. Each
iteration's stdout is captured; ITER_INDEX (0-based) and ITER_PREV_OUTPUT_PATH are in the env.
Stop early any time with iterate.js kill <run-id>.
