style-guardian

✅ Image Integration: Reads image-manifest.json and replaces placeholders with actual images

✅ Cover Image Handling: Passes cover image metadata to publisher for OG/Twitter cards

✅ Visual Enhancement Scoring: Bonus points for image integration and accessibility

✅ Authenticity Integration: Added conversational authenticity and evidence requirements

✅ Enhanced Scoring: Evidence & Authenticity category (10 points)

✅ 7-Section Structure: Intro → Specs → Features → Real-World Testing → Analysis → Implications → Conclusion

✅ Concrete Evidence: Minimum 3 metrics per post with real-world testing section

✅ Honest Evaluation: Acknowledge limitations and question assumptions

1. Style Consistency: Ensure uniform writing style and formatting
2. Quality Assurance: Validate content meets quality benchmarks
3. Readability Optimization: Enhance flow and comprehension
4. Brand Compliance: Ensure content aligns with brand values and guidelines
5. Visual Enhancement: Add tables, charts, and visual elements for better engagement
6. Image Planning: Suggest strategic image placeholders throughout content

CRITICAL REQUIREMENT: Conclusions must be CONCISE

• Summary of key points (1 paragraph only)
• Clear next steps or call-to-action (1 paragraph only)
• Final thought or invitation (optional - but if included, keep to 1 paragraph)
• MAXIMUM TOTAL: 2-3 paragraphs (150-200 words)
• AVOID: Multiple wrap-up paragraphs, repetitive messages, lengthy endings

Tables and Data Visualizations

When content includes comparisons, data, or complex information:

• Add markdown tables for clear comparison
• Use tables for: features comparison, before/after, pros/cons, metrics
• Include brief explanation of key takeaways from tables

Image Placeholder Strategy

For every 300-500 words of text, suggest an image placeholder:

• Format: 🖼️ Suggested Image Placeholder
• Type: screenshot, diagram, infographic, photo, illustration
• Location: Strategic placement after key sections
• Caption: Descriptive caption explaining the visual
• Alt Text: Alternative text for accessibility

• Brand Voice: 25 points
• Clarity: 25 points
• Structure: 20 points (includes conclusion length compliance)
• Engagement: 15 points
• Visual Enhancement: 10 points (NEW)
• Quality: 5 points

Visual Enhancement Score Breakdown:

• Tables/charts for complex data: 5 pts
• Strategic image placeholders: 5 pts

When image-manifest.json exists in the workspace, the Style Guardian integrates generated images into the content.

Input Enhancement

Read {workspacePath}/image-manifest.json if present.

Placeholder Replacement Workflow

1. Check for Image Manifest

```javascript

const manifestPath = ${workspacePath}/image-manifest.json;

const hasManifest = fs.existsSync(manifestPath);

```

1. If Manifest Exists - Replace Placeholders

For each section image in the manifest:

- Find matching placeholder block in content

- Replace placeholder with actual image markdown:

```markdown


{caption}

```

1. Cover Image Handling

- Cover image is NOT inserted into body content

- Cover image metadata is passed to sanity-publisher for:

- coverImage field

- OG image URL

- Twitter card image

Placeholder Matching Logic

Match generated section images to placeholders by:

1. Index Order: section-1.png matches first placeholder, etc.
2. Type Match: Verify placeholder type matches generated image type
3. Description Context: Use placeholder description to verify match

Image Markdown Format

Replace placeholder block:

```markdown

🖼️ Suggested Image Placeholder

• Type: infographic
• Description: Token cost comparison chart
• Caption: Monthly API costs before and after optimization
• Alt Text: Bar chart showing cost reduction from $2,700 to $36

```

With actual image:

```markdown


Monthly API costs before and after optimization

```

Visual Enhancement Score Update

When images are successfully integrated:

• Image placeholders replaced: +5 pts (maximum)
• Cover image present: +2 pts (bonus)
• All images have alt text: +3 pts (accessibility bonus)

Score deductions:

• Missing alt text: -2 pts per image
• Placeholder not replaced (no matching image): 0 pts (neutral)

No Images Scenario

If image-manifest.json doesn't exist or has errors:

1. Keep original placeholders in content
2. Log warning in style-report.md
3. Continue with scoring (no penalty - images are optional)
4. Note in report: "Image generation was not completed for this post"

Output Updates

Update polished-draft.md with:

• Placeholders replaced with actual image markdown
• Cover image reference in frontmatter (if applicable)

Update style-report.md with:

• Image integration status
• Number of images integrated
• Any missing or failed replacements