search-analytics-design

Design safe search or analytics engine adoption with reindexing and permission enforcement.

4|Updated May 16, 2026
One-click install
npx skills add https://github.com/machenjie/rd-skills --skill search-analytics-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: search-analytics-design
Source: https://github.com/machenjie/rd-skills/tree/main/src/foundation/capabilities/search-analytics-design
Command: npx skills add https://github.com/machenjie/rd-skills --skill search-analytics-design

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill prevents teams from building unjustified search or analytics engines by defining when they are necessary and how to make them safe, permission-correct, fresh enough, and operationally reliable.

Core Features & Use Cases

  • Engine selection with clear decision boundaries: Use purpose-built search/analytics only when full-text relevance, complex faceting, OLAP aggregation, or event analytics cannot be served by the source database.
  • Derived-view and source-of-truth contract: Enforces that search/analytics are derived views with explicit write-path ordering so the engine never becomes an unauthorized source of truth.
  • Permission, freshness, and reindex governance: Requires permission enforcement in every query, product-approved freshness SLOs, blue-green/zero-downtime reindexing, drift detection, and GDPR Right to Erasure handling for indexed personal data.
  • Use Case: Designing an Elasticsearch/OpenSearch/ClickHouse/Druid/Pinot plan for a multi-tenant product where users must see permission-filtered, fresh enough results with a safe reindex and measurable drift controls.

Quick Start

Use the search-analytics-design skill to produce a complete search or analytics design that includes justification, source-of-truth contract, indexed field plan, ingestion and freshness SLO, permission enforcement, zero-downtime reindex strategy, drift detection, GDPR erasure handling, fallback behavior, and observability metrics.

Frequently Asked Questions about search-analytics-design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
When do I need an external search or analytics engine instead of relational database queries?

An external search or analytics engine is necessary when full-text relevance, complex faceting, OLAP aggregation, or event analytics cannot be served by the source database or caching layers. It defines clear decision boundaries to prevent unjustified engine adoption.

How do I handle reindexing with zero downtime during schema changes?

Implement a blue-green reindex strategy with rollback capabilities to ensure zero downtime during schema changes. This approach allows you to validate the new index before switching traffic and safely revert if drift or failures are detected.

How do I enforce per-query permissions in a multi-tenant search architecture?

Multi-tenant search architecture requires permission enforcement in every query so users only see permission-filtered results. The design treats search engines as derived views, preventing them from becoming an unauthorized source of truth.

How do I manage GDPR Right to Erasure for personal data indexed in an analytics engine?

GDPR Right to Erasure handling requires explicit pathways to remove indexed personal data from the analytics engine. The design incorporates erasure controls alongside drift detection and ingestion failure monitoring to maintain compliance.

How do I set and measure freshness SLOs for derived search views?

Freshness SLOs for derived search views are product-approved thresholds measured through operational observability metrics. The design enforces explicit write-path ordering from the source of truth to ensure the indexed data meets these freshness requirements.

Best way to detect ingestion drift and failures in an event analytics pipeline?

Detect ingestion drift and failures by implementing operational observability requirements within the ingestion pipeline. The design includes measurable drift controls and fallback behavior to monitor data consistency between the source and the derived analytics engine.