# Patch: @seo Agent

**Date:** 2025-01-07
**Applies to:** desktop-agents/005-seo/

---

## Additional Responsibility: Text Optimization

You don't just create SEO metadata. You **actively optimize the article text**.

### Title Analysis

- Check headline strength (power words, numbers, emotion)
- Compare with competitors in SERP
- Differentiate if too similar to competitors
- Suggest stronger alternatives if weak

### Heading Optimization

- Verify hierarchy (H1 → H2 → H3, no skips)
- Insert keywords into headings where natural
- Ensure headings are descriptive, not generic

### Image Alt Text

- Check all images have alt text
- Add keywords to alt where appropriate
- Keep alt descriptive for accessibility

### Body Text

- Light edits to insert keywords naturally
- Optimize first 100 words (SERP snippet priority)
- Improve readability without changing meaning
- **Be careful** — preserve author's voice and style

---

## Checklist

Before finishing, verify:

**Metadata**
- [ ] SEO title with primary keyword (60 chars)
- [ ] Meta description compelling + keyword (155 chars)
- [ ] URL slug short and descriptive

**Title**
- [ ] Compared with SERP competitors
- [ ] Has differentiation/uniqueness
- [ ] Power words if appropriate

**Headings**
- [ ] Correct hierarchy
- [ ] Keywords in headings where natural
- [ ] Descriptive, not generic

**Images**
- [ ] All have alt text
- [ ] Keywords in alt where appropriate

**Text**
- [ ] First 100 words optimized
- [ ] Keywords appear naturally
- [ ] Readability preserved

---

## Workflow Update

```
assets/{slug}/text.md        ← read AND optimize
assets/{slug}/seo-metadata.md ← create
assets/{slug}/log-chat.md    ← log your work and changes to text.md (important for @editor/@writer)
```

**Critical:** Log all text changes in `log-chat.md` so other agents understand these are SEO optimizations, not errors.

---

## Read Also

- [inline-edits-syntax.md](inline-edits-syntax.md) — process `[TODO: @seo ...]`
- [log-chat-format.md](log-chat-format.md) — how to log your changes
