Help us improve
Share bugs, ideas, or general feedback.
From flow-next
Coordinates epic completion reviews verifying spec compliance across tasks using RepoPrompt or Codex backends. Triggers on /flow-next:epic-review in flow workflows.
npx claudepluginhub gmickel/flow-next --plugin flow-nextHow this skill is triggered — by the user, by Claude, or both
Slash command
/flow-next:flow-next-epic-reviewThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
**Read [workflow.md](workflow.md) for detailed phases and anti-patterns.**
Coordinates Carmack-level reviews of Flow epic specs and design docs using RepoPrompt or Codex backends via flowctl. Triggers on /flow-next:plan-review.
Verifies code implementations match specs, PRDs, epics, or tasks by checking completeness, acceptance criteria, edge cases, and scope creep. Use post- or during-implementation.
Reviews epic plans using parallel specialized agents to catch architecture, simplicity, security, and performance issues before implementation.
Share bugs, ideas, or general feedback.
Read workflow.md for detailed phases and anti-patterns.
Verify that the combined implementation of all epic tasks satisfies the spec requirements. This is NOT a code quality review (that's impl-review's job) — this confirms spec compliance only.
Role: Epic Review Coordinator (NOT the reviewer) Backends: RepoPrompt (rp) or Codex CLI (codex)
CRITICAL: flowctl is BUNDLED — NOT installed globally. which flowctl will fail (expected). Always use:
FLOWCTL="${DROID_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/flowctl"
Priority (first match wins):
--review=rp|codex|none argumentFLOW_REVIEW_BACKEND env var (rp, codex, none).flow/config.json → review.backendCheck $ARGUMENTS for:
--review=rp or --review rp → use rp--review=codex or --review codex → use codex--review=none or --review none → skip reviewIf found, use that backend and skip all other detection.
BACKEND=$($FLOWCTL review-backend)
if [[ "$BACKEND" == "ASK" ]]; then
echo "Error: No review backend configured."
echo "Run /flow-next:setup to configure, or pass --review=rp|codex|none"
exit 1
fi
echo "Review backend: $BACKEND (override: --review=rp|codex|none)"
For rp backend:
setup-review - handles window selection + builder atomically--new-chat after first reviewFor codex backend:
$FLOWCTL codex completion-review exclusively--receipt for session continuity on re-reviewsFor all backends:
REVIEW_RECEIPT_PATH set: write receipt after SHIP verdict (RP writes manually after fix loop; codex writes automatically via --receipt)<promise>RETRY</promise> and stopFORBIDDEN:
Arguments: $ARGUMENTS
Format: <epic-id> [--review=rp|codex|none]
fn-1 or fn-22-53k--review - Optional backend overrideSee workflow.md for full details on each backend.
FLOWCTL="${DROID_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/flowctl"
REPO_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
Parse $ARGUMENTS for:
fn-* → EPIC_ID--review=<backend> → backend overrideRun backend detection from SKILL.md above. Then branch:
RECEIPT_PATH="${REVIEW_RECEIPT_PATH:-/tmp/completion-review-receipt.json}"
$FLOWCTL codex completion-review "$EPIC_ID" --receipt "$RECEIPT_PATH"
# Output includes VERDICT=SHIP|NEEDS_WORK
On NEEDS_WORK: fix code, commit, re-run (receipt enables session continuity).
⚠️ STOP: You MUST read and execute workflow.md now.
Go to the "RepoPrompt Backend Workflow" section in workflow.md and execute those steps. Do not proceed here until workflow.md phases are complete.
The workflow covers:
$W and $TReturn here only after workflow.md execution is complete.
CRITICAL: Do NOT ask user for confirmation. Automatically fix ALL valid issues and re-review — our goal is complete spec compliance. Never use AskUserQuestion in this loop.
If verdict is NEEDS_WORK, loop internally until SHIP:
flowctl codex completion-review (receipt enables context)$FLOWCTL rp chat-send --window "$W" --tab "$T" --message-file /tmp/re-review.md (NO --new-chat)<verdict>SHIP</verdict>CRITICAL: For RP, re-reviews must stay in the SAME chat so reviewer has context. Only use --new-chat on the FIRST review.