Face Warp — Quality Criteria & Retry Strategy

Evaluation Prompt

Send original portrait + generated images to read_media together:

read_media(
  file_paths=[faceless_image, puzzle_image, original_portrait],
  question="Image 1 is a faceless variant, Image 2 is a puzzle variant, Image 3 is the original portrait.

  Rate each variant on a 1-10 scale. Return your evaluation in this exact format:

  FACELESS SCORES:
  face_concealment: [score] — [brief reason]
  character_consistency: [score] — [brief reason]
  natural_appearance: [score] — [brief reason]
  image_quality: [score] — [brief reason]

  PUZZLE SCORES:
  feature_accuracy: [score] — [brief reason]
  skin_tone_consistency: [score] — [brief reason]
  artistic_quality: [score] — [brief reason]
  no_full_face: [score] — [brief reason]

  VERDICT:
  faceless_pass: [true/false]
  puzzle_pass: [true/false]
  lowest_scoring_dimension: [dimension name]

  Scoring criteria below."
)

Scoring Rubric

Faceless Image

Dimension	Threshold	What to Check
face_concealment	≥ 8	Face area is completely smooth with NO recognizable eyes, nose, mouth, eyebrows
character_consistency	≥ 7	Body, clothing, hair, skin tone match the original portrait
natural_appearance	≥ 7	Smooth face looks natural and photorealistic, not like bad Photoshop
image_quality	≥ 7	Overall photographic quality — sharp, well-lit, no artifacts

Puzzle Image

Dimension	Threshold	What to Check
feature_accuracy	≥ 7	Extracted eyes, nose, lips visually match the original portrait
skin_tone_consistency	≥ 7	Skin tone of each feature piece matches the original
artistic_quality	≥ 7	Puzzle/collage is clean, well-arranged, and visually appealing
no_full_face	≥ 8	Must NOT show a complete recognizable face — only separated features

Pass/Fail Logic

PASS = all dimensions ≥ their threshold
FAIL = any dimension below threshold → retry ONLY that image

Retry only the failing image, not both
Maximum 2 retries per image
After 2 retries, keep the best-scoring version

Retry Prompt Adjustment Strategy

When retrying, append reinforcement keywords to the original prompt based on which dimension failed:

Failed Dimension	Prompt Reinforcement
face_concealment	`completely smooth featureless skin, absolutely no facial features, mannequin-like blank face`
character_consistency	`maintain exact same clothing, hair, body proportions as reference`
natural_appearance	`seamless, photorealistic skin texture, natural transition, no editing artifacts`
feature_accuracy	Strengthen specific feature descriptors, add `matching the reference portrait exactly`
skin_tone_consistency	Emphasize exact skin tone from profile, add `{skin_tone} skin matching reference`
artistic_quality	Add `clean composition, professional studio photography, minimal and elegant`
no_full_face	`no complete face, only isolated individual features with gaps between them, no connected skin`

Score Tracking

Keep track of scores across retries to select best version:

./.face-warp/{project_name}/quality_log.md

# Quality Log

## Faceless
| Attempt | face_concealment | character_consistency | natural_appearance | image_quality | Pass |
|---------|-----------------|----------------------|--------------------|---------------|------|
| 1       | ?               | ?                    | ?                  | ?             | ?    |

## Puzzle
| Attempt | feature_accuracy | skin_tone_consistency | artistic_quality | no_full_face | Pass |
|---------|-----------------|----------------------|------------------|--------------|------|
| 1       | ?               | ?                    | ?                | ?            | ?    |

3.9 KiB Raw Blame History