MiniMax H3 Prompt Review Gate (Plan v2)

Every H3 generation costs real time and VRAM, and the failure mode that hurts most is the one you could have caught by looking at the prompt for ten seconds: a reference label in the wrong shot, a shot description that reads wrong after enhancement, a dialogue line you meant to cut. Prompt Review Gate (Plan v2) is the node that forces that ten-second look. It's a prompt-only gate - no image selection happens here - that pauses before native H3 conditioning, shows you the full compiled or enhanced prompt, and lets you approve it, edit it, or let it time out.

The word "gate" is doing real work. This is the checkpoint between the prompt-refinement chain and Apply Reference Plan. If you've got the money and patience for one manual intervention in a pipeline, this is the right place for it, because everything after this point is expensive.

How it works

• h3_prompt - from Prompt Merge, the Structured Enhancer, or Apply Structured Prose.
• plan_context - the matching plan output. It already contains and routes all reference image, video, and audio values; the gate passes that media-bearing plan through unchanged.
• review_mode - the big switch. Pause for approval opens the prompt editor on every queued run. Pass through without pausing validates and forwards the pair without waiting - use it when you've already approved and don't want to click every time.
• history_limit - max approved text revisions saved for this node (default 20). History stores text only, not media.
• timeout_seconds - seconds to wait for a decision before forwarding the original prompt. 0 waits indefinitely. This is your "queue it and walk away" safety valve.

Outputs

• approved_prompt - the approved original or manually edited H3 prompt.
• approved_plan_context - the unchanged media-bearing plan plus a plan-bound prompt approval. The pack's invariant holds: prompt and plan travel as a verified pair.
• review_report - approval status and a summary of the structural locks that were verified.

Install

cd ComfyUI/custom_nodes
git clone https://github.com/ethanfel/ComfyUI-MiniMax-H3-Guide

Restart, browse MiniMax H3 → Plan v2. The gate has a small companion web module (prompt_review_server.py) in the pack that handles the editor UI; it starts with the pack and needs nothing extra.

Gotchas

• It's interactive - plan for it. With review_mode set to pause, every queue run blocks on you. That's the feature, but don't set it and forget it. The timeout_seconds escape hatch exists for a reason.
• Edits are still structural-locked. You can edit descriptive prose in the editor; structural changes get rejected, same as the rest of the pack. If you need to change a reference, edit the plan, not the gate.
• History is text-only. The media lives in the plan, not in the review history, so re-approving an old revision requires the current plan context to still match.

Where people get burned: they wire the gate up, leave it in pause mode, and wonder why batches stall. If you're running unattended, pass through or set a timeout. If you're reviewing creatively, this node is genuinely pleasant - it's the one place in the pipeline where the pack actively asks for your eyes instead of replacing them.