json-prompt-engine

Analyze a reference image (or video frame) and emit a ready-to-paste structured JSON prompt that captures every visual quality needed to reproduce it through ralphy generate image --prompt-file. The reverse of the prompt cookbook: image in -> dense JSON prompt out (scene / style / technical / materials / environment / composition / quality blocks; add a motion block for image-to-video). Adapts the schema to ralphy's model stack — gemini-3-pro-image-preview for multi-ref consistency, gpt-5.4-image-2 for crisp typography — and folds any matching @guideline:<slug> rules into the quality block. USE WHEN the user uploads or points at a reference image and asks for a prompt, "JSON prompt", "image-to-prompt", "reverse-engineer this image", "recreate this image", "describe this in prompt format", "give me the prompt for this style/look", or wants a per-slide JSON prompt for a carousel. DO NOT FIRE for conversational "what is in this image" questions, image editing, or when the user already has a brief and only wants generation (that is the art-director playbook). This runs THROUGH ralphy generate, it does not bypass the reference-required gate or the quality gate.