Analysis Best Practices

Quality guidelines and common pitfalls.

Analysis Best Practices

1. Be Specific

❌ Generic: "Is this image good?" ✓ Specific: "Does this align with brutalist aesthetic? Rate text overlay suitability."

2. Use Structured Prompts

Format analysis requests with numbered criteria for actionable feedback:

1. [Criterion A]
2. [Criterion B]
3. [Criterion C]
Overall Rating: X/10

3. Request Hex Codes

❌ Accept: "The image uses blue tones" ✓ Demand: "Extract hex codes: #1E40AF, #3B82F6, #60A5FA"

4. Compare Variations

Never settle for the first generation without comparison:

Generate 3+ variations
Analyze comparatively
Select objectively based on scores

5. Test Integration Context

Analyze assets with UI elements overlaid, not in isolation:

Mock up text overlays
Test with actual buttons and CTAs
Evaluate in responsive contexts

6. Document Decisions

Save analysis reports for design system documentation:

docs/
  assets/
    hero-image.png
    hero-analysis.md       # Analysis report
    hero-color-palette.md  # Extracted colors
  design-guidelines/
    asset-usage.md         # Guidelines derived from analysis

Common Analysis Pitfalls

❌ Vague Feedback

Analysis returns: "Colors are nice" Fix: Request specific hex codes and harmony evaluation

❌ No Numeric Rating

Analysis returns: "Pretty good quality" Fix: Always request 1-10 rating with justification

❌ Missing Context

Analyzing asset without specifying intended use Fix: Include context in prompt (hero section, background, marketing, etc.)

❌ Single Analysis Point

Only checking aesthetic, ignoring technical or integration concerns Fix: Use comprehensive evaluation template covering all dimensions

Evaluation Criteria

Core Evaluation Points

Visual coherence with chosen aesthetic direction
Color harmony and palette consistency
Composition balance and focal points
Typography compatibility (if text overlay needed)
Professional quality rating (1-10 scale)
Technical suitability (aspect ratio, resolution, file characteristics)

Context-Specific Points

For hero sections: Suitability for text overlay, visual hierarchy support
For backgrounds: Subtlety, pattern repetition quality, texture detail
For marketing: Brand alignment, emotional impact, attention-grabbing power
For decorative elements: Integration potential, visual weight, uniqueness

2.4 KiB Raw Blame History

Analysis Best Practices