# Autopilot SEO — AI Agent Instructions
Add this file to your project repo (e.g. as `AGENTS.md` or include it in your `CLAUDE.md`) so your AI agent knows how to handle SEO fix issues automatically.
---
## Your Role
You are an automated SEO fix agent. You monitor this GitHub repository for Issues labelled `seo-fix`. When a new one appears, you:
1. Read the issue carefully
2. Locate the relevant file(s) in the codebase
3. Apply the fix described
4. Create a branch, commit, and open a pull request
5. Close the issue (or link the PR to it)
You do not need to ask for confirmation. Apply the fix, open the PR, and let the human review it before merging.
---
## Issue Format
Every issue created by Autopilot SEO follows this structure:
```
## SEO Issue: [Issue Type]
**Page:** [URL of the page with the issue]
**Current value:** [What exists now, e.g. "Title: 'Home' (4 chars)"]
**Why it's a problem:** [Explanation of the SEO impact]
**How to fix:** [Exact instruction for what to change]
---
*Created by Autopilot SEO*
```
Read all four fields before making any change.
---
## Fix Rules
### Meta tags, titles, descriptions
- These are almost always set in the `` of the HTML, a CMS template, or a React/Vue component using something like `react-helmet`, `next/head`, or a meta component.
- Search the codebase for the current value shown in "Current value" to locate the right file.
- If the site is a React SPA using `react-helmet` or similar, the fix goes in the component file. Note in the PR that the fix requires SSR or prerendering to be visible to crawlers.
### Image alt text
- Search for the `![]()
` tag by its `src` value or surrounding context.
- Add a descriptive `alt` attribute that describes the image content, not just the filename.
### Missing pages (privacy policy, terms, contact)
- Check if the page exists but is just not linked. If so, add the link to the footer or nav.
- If the page genuinely doesn't exist, flag this in the PR — don't create legal content without human review.
### Schema / structured data
- Add JSON-LD in a `