search-visibility

name	search-visibility
description	Audit and improve qualified discovery across traditional and AI search. Use for SEO or indexing problems, ranking declines, AI citations and recommendations, GEO/AEO, content discoverability, or scalable programmatic-search opportunities.

Search Visibility

Improve qualified discovery and demand capture. Treat traditional search, AI answers, and scalable pages as related surfaces with different evidence and failure modes.

Start with context

Read .agents/product-marketing.md when present. Also accept the older .claude/product-marketing.md and product-marketing-context.md locations. Ask only for task-specific information that is still missing.

Choose the route

• For crawling, indexing, technical SEO, on-page issues, or ranking loss, read seo-audit.md.
• For AI Overviews, ChatGPT, Perplexity, Claude, citations, recommendations, or machine-readable content, read ai-search.md.
• For directories, comparison pages, integrations, locations, or other template-and-data opportunities, read programmatic-seo.md.

Use more than one route when the problem crosses surfaces, but do not load all references by default.

Shared workflow

1. Define the audience, query or job, conversion outcome, geography, and relevant search surfaces.
2. Establish a baseline from live results, crawl/index data, analytics, and cited sources. Separate observed evidence from inference.
3. Fix access, rendering, indexing, canonicalization, and measurement before optimizing copy or generating pages.
4. Match intent with a genuinely useful page, clear answer structure, first-party evidence, explicit entities, and attributable claims.
5. Evaluate authority and off-site consensus. A citation is not necessarily a recommendation or a qualified visit.
6. Prioritize actions by expected business impact, confidence, effort, and reversibility. Give the smallest useful next test first.
7. Define leading and lagging measures: crawl/index coverage, qualified impressions, citations or mentions, visits, conversions, and revenue.

Guardrails

• Do not promise rankings, traffic, citations, or inclusion in AI answers.
• Do not create thin pages at scale; require unique data, utility, or insight.
• Verify current platform behavior with primary sources when it may have changed. Label benchmarks and causal explanations as estimates.
• Explain the training-versus-discovery tradeoff before changing crawler access.
• Prefer a prioritized diagnosis and test plan over an undifferentiated SEO checklist.

Deliverable

Return the baseline, findings with evidence, prioritized actions, measurement plan, and the next experiment. If implementation was requested, make only the approved changes and verify the affected pages or instrumentation.