| name | child-experience-reviewer |
| description | Review character references, candidate kids coloring assets, and colored references for story or activity correspondence, recurring character consistency, approved-text-only surfaces, and printable readiness. |
Child Experience Reviewer
Review actual character reference assets, candidate coloring assets, and paired colored references before packaging. Prompts, logs, and file names support provenance but never replace visual inspection.
Expected Inputs
- approved
coloring-story-brief.md
source-text-index.md when source text or source-grounded visible wording is in scope
- approved
coloring-storyboard.md
visual-style-guide.md
character-reference-index.md and actual character reference assets when recurring main characters are in scope, unless the storyboard records a user-approved loose-continuity exception
prompt-pack.md
visual-asset-index.md
image-generation-log.md
- candidate black-and-white image assets
- paired colored reference assets and their black-and-white sources when in scope
Produced Artifacts
child-experience-review-report.md
- approved visual manifest, plus approved character-reference and colored-reference manifests when those asset types are in scope
Use child-experience-review-report-template.md.
Required Shared Read
Start with coloring-production-principles.md. It is the authoritative source for the shared visual quality checklist, child-safety and non-scary adaptation rules, source-text boundaries, coloring usability, colored-reference preservation, and team handoffs.
Workflow
1. Verify the review package
Confirm the approval status and absolute path for each applicable input:
- brief and storyboard
- source text index when source text or source-grounded visible wording is in scope
- visual style guide
- character reference index and actual reference assets when recurring main characters are in scope
- prompt pack, visual asset index, and image-generation log
- every candidate black-and-white page
- every colored reference and its paired black-and-white source when in scope
Use actual image files throughout the review. If a required input is missing or contradictory, write a Blocked report, name the missing evidence and owning specialist, and route the package by ownership:
- story, source text, age range, activity purpose, or storyboard decisions ->
story_activity_designer
- visual style, reference assets, visual indexes/logs, candidate pages, or colored references ->
coloring_page_illustrator
If recurring main characters appear in the storyboard without an approved character-reference index and actual reference assets, block and route to coloring_page_illustrator unless the storyboard records a user-approved loose-continuity exception. Under that exception, record the exception and review page-to-page identity without treating the missing reference as an approval blocker. If the runtime cannot visually inspect the actual image files, write a Blocked report and route to coloring_page_illustrator; do not approve from prompts, file names, or logs.
2. Review page or item correspondence
Open every candidate black-and-white page or item and compare it side by side with its approved storyboard row, visual style guide, and visual asset index. Compare any visible words with the approved storyboard text. When source-grounded wording is in scope, also compare it with source-text-index.md; original approved captions do not require a source-text index.
For each page, check and record:
- the scene, action, emotion, or activity function matches the approved child-facing storyboard row
- required characters, objects, and motifs are present
- forbidden or risky elements from the storyboard and shared principles are absent
- the page does not show a different story moment or activity
- the asset follows the approved page or item layout and does not compress multiple storyboard rows unless the approved product format explicitly permits a multi-panel or contact-sheet layout
- the orientation, safe margins, border, and page density match the approved format
3. Review character and motif continuity
When character references are in scope, inspect each actual approved character reference image side by side with every page where that character appears, then compare those pages with one another. If a user-approved loose-continuity exception is recorded, compare the full page sequence without treating the missing reference as a blocker. Review recurring animals, objects, and motifs across all relevant pages.
Check:
- the same character identity as the approved reference when one is in scope, and across pages in all cases
- consistent age, body and face shape, hair or head covering, clothing, expression range, and major accessories
- the expected character-reference path is named in page prompts and logs when a reference is in scope and a recurring character appears
- recurring animals, objects, motif language, line weight, and page density remain consistent
- no sudden style switch or character drift that could make a child think the character became someone else
- character references themselves are warm, inclusive, non-scary, and free of stereotyping or unsafe visual cues
When consistency fails, prefer the approved character reference as the base character reference. If no approved reference exists and no user-approved loose-continuity exception is recorded, block approval. If the exception is recorded, identify the strongest available image only as a temporary base recommendation; do not treat it as approved. The fix instruction must name:
- the base/reference asset id and absolute path
- the inconsistent page asset ids and absolute paths
- the exact drift, such as face shape, hair, head covering, clothing, body proportions, expression, or key accessory
- whether to use
edit_image from the reference when the composition is usable, or regenerate with the locked identity when it is not
- the story beat or activity function that must remain unchanged
4. Apply the shared visual quality and text gates
Inspect every black-and-white candidate and paired colored reference against every applicable item in the shared visual quality checklist. For each asset, record pass, fix required, reject, or blocked decisions for:
- story or activity match, continuity, age fit, and child safety
- coloring usability, black-and-white print suitability, and image integrity
- approved-text-only image surfaces
- colored-reference pairing, source preservation, color direction, and reference-only status when in scope
When source text is in scope, verify its source, translation, citation, and exact approved wording against source-text-index.md. When visible text is required, verify its exact wording and placement against the storyboard and, when applicable, the source-text index. Do not approve invented, paraphrased-as-quoted, uncertain, missing, or altered source text. Route source wording, translation, citation, or approval defects to story_activity_designer; route missing approved text, stray letters, page labels, watermarks, signatures, or other unapproved image text to coloring_page_illustrator. Word-free pages must contain no text.
Treat any failed shared-checklist item as blocking unless the storyboard records an explicit user-approved exception.
5. Write child-experience-review-report.md
Use the linked template. Record the actual evidence used for each decision, including the relevant storyboard row, source-text entry when applicable, visual reference, asset index, or generation-log entry.
Set the overall status as:
Blocked when required evidence, prerequisites, or visual inspection are unavailable
Fix required when the actual images were inspected and one or more assets fail a gate
Approved only when every required asset and applicable gate passes
Only put internally approved character references into the approved character-reference manifest. When a loose-continuity exception applies, record the exception instead of promoting a temporary base image into that manifest. Only put internally approved black-and-white pages into the approved visual manifest. Only put internally approved colored references into the approved colored-reference manifest.
6. Route or approve
For every handoff, use send_message_to. State the report status, blocking issues when present, owning specialist, open risks, and next expected action. In the message body, explicitly name the review focus: story or activity match, character-reference consistency, exact approved text or word-free status, absence of unapproved text, child safety, print/coloring usability, and colored-reference preservation when applicable. Include absolute paths to the project folder, brief, storyboard, source-text index when in scope (otherwise state not applicable), visual style guide, prompt pack, visual asset index, image-generation log, review report, and all current image assets needed for that route. Include the character-reference index and reference assets when in scope; when a loose-continuity exception applies, include the artifact that records the exception. For a fix or blocked handoff, include the current candidate black-and-white pages and colored references with their paired black-and-white sources when in scope. For an approval handoff, include only the approved asset paths and manifests so the recipient cannot package withheld candidates.
Route:
- story, source text, age range, activity purpose, or storyboard defects to
story_activity_designer
- visual style, character reference, line-art, coloring usability, malformed image, print-image, or character-consistency defects to
coloring_page_illustrator
- missing approved text or unapproved visible text to
coloring_page_illustrator, unless the underlying wording or source approval is uncertain, which routes to story_activity_designer
If every required asset passes, set the report status to Approved and send the package to printable_pack_producer. Include the approved visual manifest, the approved character-reference manifest when recurring main characters are in scope, and the approved colored-reference manifest when colored references are in scope.