🔧 Story Generation Debug — Full Transparency

This section is visible to administrators and contains all prompts, character data, and reference images used during generation.

📋 Generation Parameters

📝 Prompts Sent to AI

1. Story Outline Prompt (Text AI)

Generating story content

2. Character Description Prompt (Text AI)

**CHARACTER DESIGN FOR CONSISTENT ILLUSTRATION**

Character Name: Squirrel
Role: Supporting Character

🌍 ETHNICITY: Caucasian
Physical features should reflect: Caucasian/White ethnicity with features such as: light to fair skin tones, straight to wavy hair textures in various colors (blonde, brown, red, black), eye colors ranging from blue to green to brown, European facial features

📖 STORY CONTEXT:
Max loved exploring more than anything in the world! One sunny morning, he discovered a mysterious old map tucked inside his grandfather's dusty wooden chest. The map showed a hidden forest trail leading to something called the 'Golden Clearing.' Max's heart thumped with excitement. 'I can find it!' he whispered bravely. But the trail looked long and twisty, with dark shadows between the tall trees. Max felt a tiny flutter of fear in his tummy. He took a deep breath, grabbed his little backpack, and stepped outside toward the whispering forest ahead.
The forest was full of strange sounds and rustling leaves. Max's legs trembled when he reached a wide, rushing stream blocking his path. 'I can do this,' he told himself firmly. He spotted some large stepping stones and carefully hopped across, one by one. Further along, thick brambles scratched his arms, but Max pushed bravely through. Then a friendly squirrel chattered loudly above him, pointing its tiny paw toward a glowing light between the trees. Max followed the light, climbing a steep muddy hill, breathing hard, feeling his courage growing stronger with every difficult step he took.
Suddenly, Max burst into a breathtaking clearing filled with golden sunflowers swaying gently in the warm breeze. Butterflies danced around him like tiny colorful sparks. 'I made it!' Max shouted joyfully, throwing his arms wide open. He sat happily among the flowers, feeling proud and wonderfully alive. On his way home, Max smiled to himself, remembering every scary moment he had bravely faced. That evening, he told Grandfather everything. Grandfather hugged him tightly and said, 'Courage isn't about feeling no fear, Max. It means going forward even when you are scared.' Max nodded, knowing he would never forget that.


⚠️ CRITICAL: This character will appear in MULTIPLE illustrations throughout the story. EVERY detail you specify MUST remain consistent across all images. Think of this as creating a character model sheet for an animation studio.

🎨 CHARACTER DESIGN REQUIREMENTS:
- Create a UNIQUE, MEMORABLE character that fits the story theme
- Be SPECIFIC and DETAILED - vague descriptions lead to inconsistent images
- Choose DISTINCTIVE features that make the character recognizable (hairstyle, clothing, accessories)
- Ensure all features are age-appropriate and appealing to children
- Design for 3D Disney/Pixar-style animation
- Keep the character visually interesting but not overly complex
- Respect the specified ethnicity for accurate physical features

👥 CHARACTER CONSISTENCY RULES:
- Same face shape, eye color, and hair color in EVERY illustration
- Same clothing style and colors throughout the story
- Same height and build relative to other characters
- Same hairstyle and any accessories
- Same ethnic features (skin tone, facial structure, hair texture)
- These details CANNOT change between pages

📋 RETURN FORMAT:
- ONLY valid JSON, no additional text
- Use ONLY the predefined enum options for each field
- Every field must be filled - no empty values
- Gender must be exactly 'male' or 'female'
- Make all choices appropriate for a children's book character
- Ensure physical features are internally consistent (e.g., age matches height/build)
- Ensure ethnic features are accurate and respectful

❌ AVOID:
- Generic or boring designs
- Overly complex patterns or details that won't reproduce consistently
- Features that are difficult to illustrate repeatedly (e.g., 'sparkling eyes')
- Stereotypical or offensive depictions of ethnicity
- Any text or explanations outside the JSON structure

3. Book Cover Image Prompt (Image AI)

A wide landscape illustration for a children's story. Main character: Max, 7-8 years old, male, warm medium brown with natural lighter caramel highlights from sun hair, light peachy-fair with warm golden undertone, lightly sun-kissed skin, wearing bright cobalt blue short-sleeve t-shirt with a small white compass rose graphic printed on the left chest, khaki beige cargo shorts with two front pockets and one visible side cargo pocket, slightly worn at the knees. Also featuring: Grandfather, human, bright white with faint silver streaks at the temples hair, warm fair with rosy cheeks and age spots on forehead and temples skin, wearing chunky-knit dark forest green cardigan with large brown wooden buttons, worn over a soft cream-white collared shirt with the collar folded neatly over the cardigan neckline, warm brown corduroy trousers, straight cut, slightly loose fit with a brown leather belt with a round brass buckle. Also featuring: Squirrel, red_squirrel, warm_reddish_auburn_brown hair, light_warm_beige_fur_on_face skin, wearing none_natural_fur_with_cream_white_chest_patch, none_natural_fur_with_bushy_reddish_brown_tail_curved_upward. The character is in a heroic, joyful pose against a vibrant background representing the theme of adventure-and-exploration. Wide landscape banner composition, illustration only, modern Disney Pixar 3D animation style, vibrant warm colors, cinematic lighting, professional quality.

4. Per-Page Image Prompts (Image AI)

Page 1 Image Prompt:

A cheerful young boy with a backpack named Max kneeling beside a large open dusty wooden chest in a cozy attic room, holding an old yellowed treasure map with a trail marked through a forest, warm golden sunlight streaming through a small window, illustrated in a soft whimsical children's book art style, rich warm colors, detailed and inviting atmosphere, the boy's eyes wide with wonder and excitement. Featuring Max and Grandfather. Modern Disney Pixar 3D animation style, vibrant warm colors, soft cinematic lighting, professional children's book illustration, high quality

Page 2 Image Prompt:

A brave young boy named Max carefully hopping across large mossy stepping stones over a wide rushing forest stream, lush green trees surrounding him, thick brambles nearby, a friendly fluffy squirrel perched on a branch above pointing its tiny paw toward a soft glowing golden light visible between tall trees in the distance, soft dappled sunlight filtering through the canopy, whimsical children's book illustration style, vibrant greens and warm golden tones, dynamic and adventurous scene. Featuring Max and Squirrel. Modern Disney Pixar 3D animation style, vibrant warm colors, soft cinematic lighting, professional children's book illustration, high quality

Page 3 Image Prompt:

A joyful young boy named Max standing in a breathtaking sun-drenched clearing filled with tall golden sunflowers swaying gently, colorful butterflies dancing all around him, his arms spread wide open in triumph and happiness, warm glowing sunlight bathing the entire scene, in the background a cozy evening scene of the same boy being hugged tightly by a kind elderly grandfather indoors near a fireplace, soft warm tones, whimsical and heartwarming children's book illustration style, magical and uplifting atmosphere. Featuring Max and Grandfather. Modern Disney Pixar 3D animation style, vibrant warm colors, soft cinematic lighting, professional children's book illustration, high quality

👥 Character Descriptions (Generated by Text AI)

Max

{
    "character_type": "human",
    "general_appearance": {
        "age": "7-8 years old",
        "gender": "male",
        "height": "average for age, slightly compact and sturdy",
        "build": "slim but athletic, small and energetic"
    },
    "facial_features": {
        "face_shape": "round with soft cheeks, slightly square jaw, wide forehead",
        "skin_tone": "light peachy-fair with warm golden undertone, lightly sun-kissed",
        "freckles_birthmarks": "light scatter of small golden-brown freckles across nose and upper cheeks",
        "eye_shape": "large round eyes, wide and expressive with thick upper lashes",
        "eye_color": "bright warm hazel-green with golden flecks",
        "eyebrows": "medium thickness, naturally arched, warm brown, slightly bushy and expressive",
        "nose_shape": "small round button nose with a slight upward tilt",
        "lip_shape": "full rounded lips, slightly wide mouth with natural pink tone, easy broad smile",
        "teeth": "slightly gapped front two teeth, bright white, one small tooth missing on lower left suggesting recent loss"
    },
    "hair": {
        "color": "warm medium brown with natural lighter caramel highlights from sun",
        "length": "medium length, slightly overgrown, falls just above ears on sides and touches collar at back",
        "texture": "thick and curly with defined springy coils",
        "style": "naturally voluminous curls sitting full and rounded on top of head, slightly tousled and unruly, with a few loose curls falling onto forehead",
        "accessories": "none"
    },
    "clothing": {
        "top": "bright cobalt blue short-sleeve t-shirt with a small white compass rose graphic printed on the left chest",
        "bottom": "khaki beige cargo shorts with two front pockets and one visible side cargo pocket, slightly worn at the knees",
        "shoes": "sturdy red canvas lace-up sneakers with white rubber soles and white laces, slightly muddy at the toe",
        "accessories": "small olive green canvas backpack with two front pockets worn on both shoulders, one front pocket slightly unzipped; thin brown leather friendship bracelet on right wrist"
    },
    "non_human_traits": {
        "species": "human",
        "abilities": "none supernatural",
        "distinctive_features": "bright expressive hazel-green eyes that convey emotion clearly, prominent freckle cluster across nose, voluminous springy brown curls that bounce with movement, gap-toothed broad smile, signature cobalt blue compass t-shirt and red sneakers for instant recognition across all illustrations"
    }
}

Grandfather

{
    "character_type": "supporting_character",
    "general_appearance": {
        "age": "75-80 years old",
        "gender": "male",
        "height": "medium (5'8")",
        "build": "stocky and slightly rounded, with a warm soft belly, broad shoulders slightly hunched with age"
    },
    "facial_features": {
        "face_shape": "wide oval with soft rounded cheeks, deep laugh lines, and a strong jawline softened by age",
        "skin_tone": "warm fair with rosy cheeks and age spots on forehead and temples",
        "freckles_birthmarks": "light age spots scattered across forehead and both cheeks, small oval birthmark above left eyebrow",
        "eye_shape": "deep-set, slightly hooded with pronounced crow's feet wrinkles at outer corners, warm and crinkled when smiling",
        "eye_color": "pale steel blue with a warm twinkle",
        "eyebrows": "thick bushy white eyebrows, slightly overgrown and expressive, arching gently upward toward center",
        "nose_shape": "large broad rounded nose with a slight bulbous tip, prominent and characterful",
        "lip_shape": "thin upper lip, fuller lower lip, always carrying a warm gentle smile with deep smile lines framing the mouth",
        "teeth": "slightly imperfect, ivory-white, with a small gap between front two teeth, upper teeth slightly visible when smiling"
    },
    "hair": {
        "color": "bright white with faint silver streaks at the temples",
        "length": "short on sides, slightly longer on top",
        "texture": "soft and slightly wavy",
        "style": "neatly combed to one side on top with a natural wave, short and tidy at the sides and back, thin at the crown showing a little scalp",
        "accessories": "none"
    },
    "clothing": {
        "top": "chunky-knit dark forest green cardigan with large brown wooden buttons, worn over a soft cream-white collared shirt with the collar folded neatly over the cardigan neckline",
        "bottom": "warm brown corduroy trousers, straight cut, slightly loose fit with a brown leather belt with a round brass buckle",
        "shoes": "dark brown leather slippers with thick soles, round toes, and a small tan stitched trim around the edge",
        "accessories": "round wire-rimmed spectacles with thin silver frames resting low on his nose, a worn brown leather watch with a cream face on his left wrist, and a small soft red pocket square folded into a triangle tucked into the cardigan breast pocket"
    },
    "non_human_traits": {
        "species": "human",
        "abilities": "none",
        "distinctive_features": "bushy expressive white eyebrows that raise dramatically when surprised, rosy apple cheeks that glow warmly when laughing, wire-rimmed spectacles always slightly crooked on his nose, small gap between front teeth visible in his wide warm smile, and a cozy well-worn green cardigan that is his defining visual signature across all scenes"
    }
}

Squirrel

{
    "character_type": "supporting_character",
    "general_appearance": {
        "age": "adult_animal",
        "gender": "female",
        "height": "very_small",
        "build": "tiny_and_slender"
    },
    "facial_features": {
        "face_shape": "round_and_small",
        "skin_tone": "light_warm_beige_fur_on_face",
        "freckles_birthmarks": "none",
        "eye_shape": "large_round_and_wide",
        "eye_color": "bright_hazel_brown",
        "eyebrows": "thin_short_arched_expressive",
        "nose_shape": "tiny_round_button_nose",
        "lip_shape": "small_curved_with_gentle_smile",
        "teeth": "two_small_prominent_front_buckteeth_white"
    },
    "hair": {
        "color": "warm_reddish_auburn_brown",
        "length": "short_full_body_fur",
        "texture": "soft_fluffy_fine",
        "style": "smooth_flat_on_head_with_fluffy_cheek_tufts",
        "accessories": "tiny_single_red_ribbon_bow_tied_at_base_of_left_ear"
    },
    "clothing": {
        "top": "none_natural_fur_with_cream_white_chest_patch",
        "bottom": "none_natural_fur_with_bushy_reddish_brown_tail_curved_upward",
        "shoes": "none_small_rounded_paws_with_tiny_visible_claws",
        "accessories": "none"
    },
    "non_human_traits": {
        "species": "red_squirrel",
        "abilities": "tree_climbing_chattering_communication_and_pointing_with_tiny_paw_to_guide_others",
        "distinctive_features": "oversized_fluffy_reddish_brown_tail_curling_high_over_back_large_expressive_hazel_eyes_cream_white_belly_patch_small_pointy_ears_with_tiny_inner_ear_tufts_and_signature_red_ribbon_bow_on_left_ear"
    }
}

🖼️ Character Reference Images (Used for Consistency)