Video Validation System¶

Overview¶

This validation system ensures all Nutri-E educational videos meet medical accuracy, legal compliance, and brand consistency standards before publication.

Why This System Exists¶

Problem: In previous video productions, character design consistency checks were sometimes skipped, leading to: - Inconsistent character styles between symptoms - Time wasted regenerating videos - Credits wasted on non-compliant content - Brand confusion for viewers

Solution: Mandatory 14-item checklist with automated enforcement scripts.

The 14-Item Validation Checklist¶

Location: MARKETING_GUIDE.md lines 969-983

Visual Verification (Lines 1-6)¶

LINE 1: "VITAMIN [X] DEFICIENCY" visible at very top
LINE 2: Symptom name in large bold font
LINE 3: Brief description in medium font
LINE 4: "Source: NIH Office of Dietary Supplements" legible at bottom
Vitamin/nutrient name correct (matches video series)
"DEFICIENCY" or "EXCESS" clearly stated

Content Verification (Lines 7-11)¶

Symptom matches NIH ODS factsheet
Source is ONLY NIH Office of Dietary Supplements (no other sources)
Citation legible and properly formatted
NIH URL documented in validation report
No exaggerated claims beyond NIH statements

Character Design Verification (Line 12 - CRITICAL)¶

🚨 MANDATORY: Compare to official mascot reference image BEFORE validation

Reference: /Users/post/repos/github/nutri-e/website/images/nutri-e-mascot.png

Nutri-E character design matches brand mascot:
- ✅ Cream/beige FACE visible (not just purple body with features)
- ✅ Purple hood/body surrounding face (egg-shaped)
- ✅ Eyes with white circular outlines around black pupils with highlights
- ✅ Brown eyebrows visible (not purple, not missing)
- ✅ Soft pink cheeks (gentle blush)
- ✅ 3D render style matches reference
- ✅ Vitamin marking visible on belly (if applicable)
- ✅ Empathetic expression appropriate for symptom (not scary)

Technical Verification (Lines 13-14)¶

Background color appropriate for symptom theme
Text readable with dark outline/shadow contrast

Validation Tools¶

1. Validation Report Template¶

File: validation-report-template.md

Purpose: Structured document for recording all 14 validation items for each symptom.

Usage:

# Copy template for your vitamin
cp validation-report-template.md validation-report-B12.md

# Fill out ALL sections for each symptom
# Mark items as [x] when verified
# Add notes for any concerns

What it includes: - Frame-by-frame verification for all 6 symptoms - All 14 checklist items per symptom - Character design sub-checklist (6 items under #12) - Final video sequence validation - Technical specs verification - Sign-off section for legal compliance

2. Validation Enforcer Script¶

File: scripts/validate-video.sh

Purpose: Interactive script that extracts frames and prompts you to confirm ALL 14 items are checked.

Usage:

cd /path/to/nutri-e/repo

# Run validation
./scripts/validate-video.sh "B12" "/path/to/vitamin-b12-deficiency-compliant.mp4"

What it does: 1. ✅ Checks video file exists 2. ✅ Shows video duration and file size 3. ✅ Extracts 8 verification frames 4. ✅ Displays full 14-item checklist 5. ✅ Prompts you to open and review all frames 6. ✅ Asks: "Have you verified ALL 14 items for ALL symptoms?" 7. ✅ Asks: "Is the Nutri-E character consistent across all frames?" 8. ✅ Asks: "Have you created validation-report-[vitamin].md?" 9. ✅ Blocks progression if any answer is "no"

Safety Features: - Requires explicit "yes" confirmation for each checkpoint - Highlights character design verification as CRITICAL - Prevents skipping validation by blocking with exit codes - Reminds you to create validation report

3. Validation Checkpoints in MARKETING_GUIDE.md¶

Locations:

Checkpoint 1 (After Step 8: Compilation) - Line 1575 - Appears immediately after video compilation - Prevents proceeding to next step without validation

Checkpoint 2 (Before Step 9: Validation) - Embedded in Step 9 instructions - References validation script and template - Updates existing validation section with new tools

Checkpoint 3 (Before Workflow Summary) - Line 1943 - Appears before "Workflow Summary Checklist" - Final reminder before considering video complete

What they say: - 🚨 VALIDATION CHECKPOINT header (cannot be missed) - Required actions with checkbox list - References to validation tools (script, template, checklist) - Explicit emphasis on character design (item #12) - Warning: "DO NOT SKIP"

Validation Workflow¶

Step 1: Complete Video Compilation¶

ffmpeg -f concat -safe 0 -i filelist-compliant.txt \
  -c copy vitamin-b12-deficiency-compliant.mp4 -y

Step 2: Run Validation Enforcer¶

./scripts/validate-video.sh "B12" "/path/to/vitamin-b12-deficiency-compliant.mp4"

Script will automatically:

STEP 0 (MANDATORY - ADDED OCT 28, 2025): - Auto-open mascot reference: website/images/nutri-e-mascot.png - Display key mascot features to study: - Cream/beige FACE inside purple hood/body - White circular eye outlines - Brown eyebrows - Pink cheeks - Display common mistakes to avoid (purple blob = WRONG) - BLOCK progression until you confirm you've studied the mascot

THEN: - Extract frames to validation-frames-[timestamp]/ - Display 14-item checklist - Prompt for manual verification

Step 3: Compare Frames to Mascot Reference¶

open validation-frames-*/

🚨 CRITICAL: Side-by-side comparison: 1. Keep mascot reference image open (already opened by script in Step 0) 2. Open extracted frames folder 3. For EACH frame, verify: - ✅ Cream/beige FACE inside purple body (not just purple blob) - ✅ White circular eye outlines (not plain eyes) - ✅ Brown eyebrows visible (not purple, not missing) - ✅ Pink cheeks present - ✅ Character matches mascot reference

Also check: - Correct text overlays (all 4 lines) - NIH citation visible at bottom

Step 4: Create Validation Report¶

cp validation-report-template.md validation-report-B12.md

Fill out report: - Document each symptom's verification (all 14 items) - Mark character design sub-items under #12 - Add notes for any concerns - Sign and date the report

Step 5: Confirm in Script¶

Return to validation script and answer prompts:

❓ Have you opened and reviewed ALL frames? yes
❓ Have you verified ALL 14 items for ALL symptoms? yes
❓ Have you compared frames to website/images/nutri-e-mascot.png? yes
❓ Does character match Nutri-E mascot (cream face, brown eyebrows, pink cheeks)? yes
❓ Is the Nutri-E character consistent across all frames? yes
❓ Have you created validation-report-B12.md? yes

⚠️ Script will BLOCK if: - You haven't compared to mascot reference - Character doesn't match mascot design - Any validation item incomplete

Step 6: Archive Report¶

# Store validation report with video assets
mv validation-report-B12.md "/path/to/Vitamin-B12/"

When Validation Fails¶

Character Does Not Match Nutri-E Mascot (CRITICAL FAILURE - Oct 28, 2025)¶

Symptom: Character is a generic purple blob WITHOUT cream/beige face, brown eyebrows, or white eye outlines

Real-world incident: B12 video initial validation (Oct 28, 2025) - Symptom videos showed purple egg characters with features directly on body - Validator checked characters were "consistent with each other" ✅ - Validator FAILED to compare with official Nutri-E mascot reference ❌ - Result: All 6 symptom videos had WRONG character design - Cost: 6 videos × 35 credits = 210 credits wasted + regeneration time

Root Cause: Validation system did not require comparing frames to official mascot reference image

Prevention (MANDATORY as of Oct 28, 2025): - ✅ Validation script now REQUIRES mascot reference comparison - ✅ Two explicit prompts added: - "Have you compared frames to website/images/nutri-e-mascot.png?" - "Does character match Nutri-E mascot (cream face, brown eyebrows, pink cheeks)?" - ✅ Script blocks progression if answer is "no"

Solution when this occurs: 1. ❌ STOP IMMEDIATELY - Do NOT proceed with video 2. Open website/images/nutri-e-mascot.png and study the design: - Cream/beige FACE inside purple hood/body - White circular eye outlines around black pupils - Brown eyebrows - Soft pink cheeks 3. Regenerate ALL symptom images in Nutri-E Brand Assets ChatGPT project 4. UPLOAD mascot reference image to ChatGPT conversation 5. EXPLICITLY REQUEST in prompt: "Match the Nutri-E mascot design exactly: cream face, brown eyebrows, white eye outlines, pink cheeks" 6. Verify EACH generated image against mascot before proceeding 7. Re-generate videos in KlingAI 8. Re-run validation WITH mascot comparison

Character Design Inconsistency Between Symptoms¶

Symptom: Character looks different between symptoms (different colors, styles, proportions)

Cause: Images generated outside Nutri-E Brand Assets project

Solution: 1. ❌ Stop - Do NOT proceed with video 2. Regenerate ALL symptom images in Nutri-E Brand Assets ChatGPT project 3. Upload mascot reference to project conversation 4. Re-generate videos in KlingAI 5. Re-run validation

Missing NIH Citation¶

Symptom: LINE 4 citation missing or illegible

Cause: Prompt didn't include source requirement

Solution: 1. Regenerate image with citation in prompt 2. Re-upload to KlingAI 3. Download new video 4. Replace in compilation 5. Re-run validation

Wrong Symptom Content¶

Symptom: Symptom not found in NIH ODS factsheet

Cause: Used non-NIH source or made assumption

Solution: 1. Re-research from NIH ODS ONLY 2. Find NIH-validated symptom 3. Regenerate image with correct content 4. Re-upload to KlingAI 5. Download and replace 6. Re-run validation

Legal Compliance¶

Why validation reports are required: - Health content claims require credible source backing - Character consistency = brand recognition = trust - Documentation protects against misinformation lawsuits - NIH-only sourcing is most legally defensible

Retention: - Archive validation reports with video assets - Keep for minimum 7 years (legal standard for health content) - Include in video metadata when possible

Troubleshooting¶

"I can't run the validation script"¶

Problem: Permission denied or command not found

Solution:

# Make script executable
chmod +x scripts/validate-video.sh

# Check it's executable
ls -l scripts/validate-video.sh
# Should show: -rwxr-xr-x

"Validation script says ffmpeg not found"¶

Problem: FFmpeg not installed

Solution:

# Install FFmpeg
brew install ffmpeg

# Verify installation
ffmpeg -version

"I want to skip validation for this one video"¶

Answer: NO. Validation is mandatory for ALL videos.

If you skip validation: - Risk publishing non-compliant content - Legal liability for inaccurate health claims - Brand damage from inconsistent character design - Viewer confusion and lost trust

There are no exceptions to the 14-item checklist.

Summary¶

Before publishing ANY Nutri-E educational video:

✅ COMPARE frames to website/images/nutri-e-mascot.png (MANDATORY as of Oct 28, 2025)
✅ Run ./scripts/validate-video.sh [VITAMIN] [video-file.mp4]
✅ Complete ALL 14 items on checklist (lines 969-983)
✅ Verify character matches Nutri-E mascot (item #12 - CRITICAL):
Cream/beige FACE inside purple body
White circular eye outlines
Brown eyebrows
Pink cheeks
✅ Create validation-report-[vitamin].md
✅ Archive validation report with video assets

Mascot reference comparison is MANDATORY. Failure to compare = validation failure.

Questions?¶

See also: - MARKETING_GUIDE.md (main workflow documentation) - validation-report-template.md (blank template) - scripts/validate-video.sh (enforcement script)

Validation checkpoints in MARKETING_GUIDE.md: - Line 1575 (after compilation) - Line 1596 (Step 9: Validate) - Line 1943 (before workflow summary)