glow/first-home-diy
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Content infrastructure: Add photo/video step guidance template to briefs #51

New issue
Closed
opened 2026-06-09 20:48:09 +00:00 by glow · 1 comment
glow commented 2026-06-09 20:48:09 +00:00
Owner
Copy link

Problem

Article bodies currently have no standardized image placement. Some articles have no visual steps, making complex repairs harder to follow.

Competitor advantage

  • This Old House: photo per step
  • Family Handyman: annotated tool photos
  • The Spruce: professional photography throughout

Suggested fix

  1. Add imagePoints field to briefs — key steps that MUST have a photo
  2. Add expectedImages count to validator checks
  3. Integrate with xAI Grok image generation to auto-generate step images from article body content
  4. Target: minimum 3 images per article (hero, tools, one key step)

Priority

Medium — tied to Grok image gen pipeline (Issue #37)

## Problem Article bodies currently have no standardized image placement. Some articles have no visual steps, making complex repairs harder to follow. ## Competitor advantage - This Old House: photo per step - Family Handyman: annotated tool photos - The Spruce: professional photography throughout ## Suggested fix 1. Add `imagePoints` field to briefs — key steps that MUST have a photo 2. Add `expectedImages` count to validator checks 3. Integrate with xAI Grok image generation to auto-generate step images from article body content 4. Target: minimum 3 images per article (hero, tools, one key step) ## Priority Medium — tied to Grok image gen pipeline (Issue #37)
glow self-assigned this 2026-06-09 20:48:09 +00:00
glow closed this issue 2026-06-09 21:55:36 +00:00
glow commented 2026-06-09 21:55:38 +00:00
Author
Owner
Copy link

Fixed in commit c10891d.

TEMPLATE-repair.md — added two new sections after Required H2s:

  • Image/photo requirements — defines required photo types (hero, tools, diagnosis, steps 1/4/5/7, final result)
  • Video integration (optional) — companion video specs (2-5 min, YouTube shorts for key techniques)

validate-article.ts — upgraded image check:

  • Repair pillar articles now require ≥3 images in the body (warns if fewer)
  • Other pillars retain the original ≥1 image or hero check
  • Uses proper count (not just presence test), with a helpful warning message suggesting what photos to add

Closes #51

Fixed in commit c10891d. **TEMPLATE-repair.md** — added two new sections after Required H2s: - `Image/photo requirements` — defines required photo types (hero, tools, diagnosis, steps 1/4/5/7, final result) - `Video integration (optional)` — companion video specs (2-5 min, YouTube shorts for key techniques) **validate-article.ts** — upgraded image check: - Repair pillar articles now require **≥3 images** in the body (warns if fewer) - Other pillars retain the original ≥1 image or hero check - Uses proper count (not just presence test), with a helpful warning message suggesting what photos to add Closes #51
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
No results found.
Labels
Clear labels   
bug
Bug fix

  
feature
New feature

  
improvement
Code improvements and refactors

No labels
bug
feature
improvement
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
glow
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
glow/first-home-diy#51
No description provided.