marketplace-search-recsys-planning

• AGENTS.mddoc · 16,225 bytes
• README.mddoc · 7,293 bytes
• SKILL.mdcore · 14,778 bytes
• assets/templates/_template.mddoc · 2,469 bytes
• gotchas.mddoc · 1,521 bytes
• metadata.jsonasset · 3,210 bytes
• references/_sections.mddoc · 3,956 bytes
• references/arch-avoid-mono-stack-retrieval.mddoc · 1,893 bytes
• references/arch-design-for-cold-start-from-day-one.mddoc · 1,875 bytes
• references/arch-design-zero-result-fallback.mddoc · 2,199 bytes
• references/arch-map-surface-to-retrieval-primitive.mddoc · 1,847 bytes
• references/arch-route-surfaces-deliberately.mddoc · 2,210 bytes
• references/arch-split-candidate-generation-from-ranking.mddoc · 2,515 bytes
• references/blend-combine-search-and-personalisation-scores.mddoc · 2,071 bytes
• references/blend-keep-hybrid-blending-explainable.mddoc · 1,736 bytes
• references/blend-never-return-zero-results.mddoc · 1,968 bytes
• references/blend-use-search-alone-for-specific-intent.mddoc · 1,643 bytes
• references/index-design-mappings-conservatively.mddoc · 1,857 bytes
• references/index-match-index-and-query-time-analyzers.mddoc · 1,708 bytes
• references/index-separate-searchable-from-display-fields.mddoc · 1,808 bytes
• references/index-stream-listing-updates-via-cdc.mddoc · 2,072 bytes
• references/index-use-index-templates-for-consistency.mddoc · 2,171 bytes
• references/index-use-keyword-and-text-as-multi-fields.mddoc · 1,399 bytes
• references/index-use-language-analyzers-for-language-fields.mddoc · 1,630 bytes
• references/intent-audit-live-query-logs-first.mddoc · 1,854 bytes
• references/intent-distinguish-transactional-from-exploratory.mddoc · 1,637 bytes
• references/intent-map-queries-to-intent-classes.mddoc · 1,792 bytes
• references/intent-reject-one-search-for-everything.mddoc · 1,932 bytes
• references/intent-separate-known-item-from-discovery.mddoc · 1,806 bytes
• references/intent-treat-no-search-as-first-class-choice.mddoc · 1,822 bytes
• references/measure-define-session-success-per-surface.mddoc · 1,758 bytes
• references/measure-run-interleaving-as-cheap-ab-proxy.mddoc · 1,744 bytes
• references/measure-track-ndcg-mrr-zero-result-rate.mddoc · 1,567 bytes
• references/measure-track-reformulation-rate-as-failure-signal.mddoc · 1,796 bytes
• references/measure-use-click-models-for-implicit-judgments.mddoc · 2,084 bytes
• references/monitor-alert-on-decision-triggers.mddoc · 2,204 bytes
• references/monitor-build-search-health-dashboard.mddoc · 2,024 bytes
• references/monitor-log-every-query-with-full-context.mddoc · 1,940 bytes
• references/monitor-run-weekly-search-quality-review.mddoc · 1,763 bytes
• references/monitor-scrub-pii-from-query-logs.mddoc · 2,385 bytes
• references/monitor-track-ranking-stability-churn.mddoc · 1,880 bytes
• references/plan-audit-before-you-build.mddoc · 1,917 bytes
• references/plan-build-golden-query-set-first.mddoc · 1,782 bytes
• references/plan-find-bottleneck-before-optimising.mddoc · 1,944 bytes
• references/plan-handoff-to-personalisation-skill.mddoc · 1,987 bytes
• references/plan-maintain-a-decisions-log.mddoc · 2,015 bytes
• references/plan-version-the-golden-set.mddoc · 1,720 bytes
• references/playbooks/improving.mddoc · 13,946 bytes
• references/playbooks/planning.mddoc · 11,028 bytes
• references/query-build-autocomplete-on-separate-index.mddoc · 1,474 bytes
• references/query-classify-before-routing.mddoc · 1,918 bytes
• references/query-curate-synonyms-by-domain.mddoc · 1,777 bytes
• references/query-normalise-before-anything-else.mddoc · 1,812 bytes
• references/query-use-fuzzy-matching-for-typos.mddoc · 1,246 bytes
• references/query-use-language-analyzers-for-stemming.mddoc · 1,311 bytes
• references/rank-apply-diversity-at-rank-time.mddoc · 1,826 bytes
• references/rank-deploy-ltr-only-after-golden-set-exists.mddoc · 1,994 bytes
• references/rank-normalise-scores-across-retrieval-primitives.mddoc · 2,218 bytes
• references/rank-tune-bm25-parameters-last.mddoc · 1,456 bytes
• references/rank-use-function-score-for-business-signals.mddoc · 1,865 bytes
• references/retrieve-choose-embedding-model-deliberately.mddoc · 2,254 bytes
• references/retrieve-combine-bm25-and-knn-via-hybrid-search.mddoc · 1,769 bytes
• references/retrieve-paginate-with-search-after.mddoc · 1,378 bytes
• references/retrieve-run-expensive-signals-in-rescore.mddoc · 1,716 bytes
• references/retrieve-use-bool-structure-deliberately.mddoc · 1,602 bytes
• references/retrieve-use-filter-clauses-for-exact-matches.mddoc · 1,469 bytes

# Marketplace Engineering Two-Sided Search and Recsys Planning Best Practices

Comprehensive planning, design and diagnostic guide for search and recommendation systems
in two-sided trust marketplaces. Covers OpenSearch index, query and ranking patterns, the
methodology for planning retrieval work, the handoff points to recommendation-specific
tooling, and the instrumentation and dashboard layer that turns measurement into ongoing
decision making. Contains 57 rules across 10 categories ordered by cascade impact, plus
two playbooks (plan a new system from scratch, diagnose an existing one) and explicit
living-artefact conventions (decisions log, golden set, gotchas).

## When to Apply

Reference this skill when:

- Planning a new marketplace retrieval project from scratch