Docs: AI Search Specialist — description auto-optimization (DAT-4274)

[haleyserrano]

JIRA

DAT-4274 — Description Optimization (Search AI Specialist): relevance-gated refresh + revert path

---

Change classification

Feature behavior change — Partner-facing documentation (partner education on a new autonomous Business App feature)

Repo target: Partner Center (partner/reseller-facing docs)

---

Summary of changes

File	Action	Description
docusaurus/docs/ai/ai-workforce/ai-search-specialist.md	Created	New partner-facing article explaining what the AI Search Specialist does, requirements, what clients experience, and answers to common client questions partners will need to handle
docusaurus/docs/ai/ai-workforce/index.mdx	Updated	Added AI Search Specialist to the AI Employee guides list

---

New vs. existing docs

New page created. No existing page in the Partner Center AI Workforce section covers the AI Search Specialist. The feature represents a significant autonomous behavior (monthly profile description rewrites) that partners need to understand to support their clients effectively.

Placement reasoning: The existing Partner Center AI Workforce section at docusaurus/docs/ai/ai-workforce/ mirrors the Business App AI Workforce structure and is the correct home for AI Employee documentation. Added alongside AI Sales Assistant, AI Voice Receptionist, and AI Chat Receptionist.

---

Acceptance criteria coverage

AC	Documented?	Where
AC#1 — Detection: 90-day age flag	✅	"How it works" — 90-day recency gate
AC#2 — Relevance gate: skip if nothing meaningful changed	✅	"How it works"
AC#3 — Tracked keywords only; website + profile inputs	✅	"How it works" bullet list; Requirements section
AC#5 — Sync to Google, Bing, Apple, Facebook	✅	"What clients experience" step 3
AC#6 — Notification links to Business Profile	✅	"What clients experience" steps 1–2
AC#4 — Re-optimization guard (post-revert)	⏭️	Not documented — revert (DAT-4288) not yet shipped

---

Figma / images

No Figma links or screenshots were provided in the JIRA story. No images added.

---

Skills used

• Repository search (mcp__github__search_code) — confirmed no existing AI Search Specialist documentation in this repo
• JIRA issue lookup (mcp__Atlassian__getJiraIssue) — sourced acceptance criteria and feature scope
• GitHub PR search (mcp__github__search_pull_requests) — identified code authors and confirmed merged feature PRs

---

Assumptions and limitations

• The revert feature (DAT-4288) is not yet shipped and is intentionally excluded.
• Partner Center content is partner-facing (can reference Vendasta branding); Business App content is gray-labeled (no Vendasta branding).
• "Local SEO Premium" is the activating subscription tier, sourced from the code PR descriptions.

---

@ahnikakuse @haleyserrano @maryam6samadi

---

Generated by Claude Code

[nisarg-va]

FYI:
Its not 100% true that the description will be optimized when new services and keywords are recognized. Its more of an AI judgement to do this work. And description optimization happens after 90 days - to avoid changing user descriptions very often. So if a description was updated 90 days ago, it likely won't get updated by Profile optimization workflow.