Jetpack Search: Add Answers UI

projects/packages/search/AGENTS.md

@@ -0,0 +1,54 @@
+# Jetpack Search
+
+## UI Components
+
+**Always use existing design system components instead of writing custom ones.**
+
+The Jetpack Search dashboard is actively migrating to standard WordPress components. When building UI, follow this priority order:
+
+### Priority 1: `@wordpress/ui`
+The primary component library for new Jetpack work. Use for:
+- `Button`, `Link`
+- `Notice.Root` / `Notice.Title` / `Notice.Description`
+- Tabs, dialogs, and layout primitives
+
+### Priority 2: `@wordpress/components`
+Fallback for anything not yet in `@wordpress/ui`:
+- `ToggleControl`, `TextareaControl`, `SelectControl`
+- `Tabs`, `TabPanel`
+- `Notice` (legacy)
+
+### Priority 3: `@automattic/jetpack-components`
+Jetpack-specific components (upsell cards, plan badges, etc.).
+
+### Never reinvent
+Do **not** create custom implementations of:
+- Tab bars → use `@wordpress/components` `Tabs` or `@wordpress/ui`
+- Buttons → use `@wordpress/ui` `Button`
+- Notices/alerts → use `@wordpress/ui` `Notice`
+- Toggles/checkboxes → use `@wordpress/components` `ToggleControl`
+
+When unsure which component to use, the `@wordpress/design-system-mcp` MCP is configured for this project — use it to look up the right component before building a custom one.
+
+## Data access
+
+- `@automattic/jetpack-shared-extension-utils` → `getSiteFragment()` for site domain
+- `@automattic/jetpack-script-data` → `isWpcomPlatformSite()` for WP.com detection
+- Store selectors via `useSelect( select => select( STORE_ID ).selectorName(), [] )` — always include `[]` dependency array
+
+## Testing
+
+Always run all three suites when changing search code:
+
+```bash
+# JS tests (from projects/packages/search/)
+pnpm test-scripts
+
+# Search PHP tests
+jetpack test php packages/search -v
+
+# Sync PHP tests — search changes often affect the sync whitelist
+jetpack test php packages/sync -v
+```
+
+- Mock external packages in tests; mock custom hooks (`hooks/use-*`) rather than their internals

projects/packages/search/changelog/jps3-answers-plan

@@ -0,0 +1,4 @@
+Significance: minor
+Type: added
+
+Search: AI Answers — topic-based customization CPTs, HMAC auth token, dashboard tabs, and streaming answers panel in the instant-search overlay.