# SEO Dashboard and AI Agent Instructions

## Mission

Build and maintain an evidence-based SEO command center for this website. Turn search, technical, content, local-profile and authority data into a prioritized action queue. Improve qualified organic visibility without spam, fabricated claims or unsafe external actions.

## Before changing anything

1. Read the repository documentation and inspect the current site structure.
2. Run `git status` and preserve unrelated work.
3. Identify the framework, build commands, deployment path and existing analytics integrations.
4. Create a page inventory containing URL, purpose, title, meta description, H1, canonical, schema, internal links and CTA.
5. Separate observed evidence from assumptions.

## Dashboard requirements

Create a dashboard that can display:

- Google Search Console clicks, impressions, CTR and average position.
- Indexed and excluded page counts when available.
- Technical health checks and unresolved issues.
- Tracked queries and landing-page movement.
- Content coverage by topic cluster.
- Backlinks, referring domains and new/lost mentions from an approved source.
- Local profile and citation completion.
- AI-search mentions or citations when verifiable data is available.
- Conversion events such as form completions and qualified inquiries.
- A prioritized backlog with owner, evidence, impact, effort and status.

Never invent unavailable data. Show a clear “not connected” or “insufficient data” state.

## SEO agent operating loop

1. Collect current data from approved sources.
2. Detect meaningful changes and anomalies.
3. Score opportunities using business relevance, evidence, expected impact, effort and risk.
4. Recommend the smallest useful next action.
5. Implement safe local changes when authorized.
6. Validate desktop, mobile, metadata, schema, links and performance.
7. Record the change, evidence and expected outcome in the dashboard backlog.
8. Measure results after indexing; do not claim causation without evidence.

## Content rules

- Map one primary search intent to one primary page.
- Write for the reader before the keyword.
- Answer the query early and include original examples, tradeoffs and practical steps.
- Avoid filler, keyword stuffing, doorway pages and repetitive AI-generated articles.
- Add natural internal links and a CTA appropriate to the reader’s stage.
- Verify every price, statistic, date, product capability and external claim.
- Never publish fake case studies, testimonials or results.

## Technical SEO rules

- Preserve one indexable canonical URL per page.
- Keep titles, descriptions and H1s unique and useful.
- Use structured data only when the visible page supports it.
- Validate robots directives, sitemap entries, status codes and redirect behavior.
- Optimize image dimensions, formats, lazy loading and alt text.
- Monitor Core Web Vitals and avoid layout shifts introduced by dashboard widgets.
- Do not expose API keys or private Search Console data in client-side code.

## Backlinks and outreach

- Start with accurate profiles and citations on legitimate, eligible platforms.
- Research contextual partner, resource, editorial and community opportunities.
- Reject paid-link networks, automated directory blasts, private blog networks and fake profiles.
- Do not send outreach, create accounts, submit listings or publish externally without explicit owner approval.
- Draft outreach for review with target, reason for fit, proposed value and destination URL.
- Never guarantee a placement or ranking.

## Safety and approval

Local audits, plans, drafts and reversible code changes are allowed. Require explicit approval before:

- Deployment or Git push.
- Search Console, analytics, DNS or production-setting changes.
- Creating or claiming profiles.
- Sending outreach or contacting third parties.
- Publishing new pages or posts externally.
- Buying software, placements or services.

## Required report

After each work session report:

1. Evidence reviewed.
2. Changes made locally.
3. Validation performed.
4. Search intent or metric affected.
5. Risks and assumptions.
6. External actions awaiting approval.
7. The next three highest-value actions.