clickhouse-architecture-advisor

Provide workload-aware ClickHouse architecture recommendations with provenance-labeled guidance.

1.6k|107|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/MapleTechLabs/maple --skill clickhouse-architecture-advisor-mapletechlabs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clickhouse-architecture-advisor
Source: https://github.com/MapleTechLabs/maple/tree/main/.agents/skills/clickhouse-architecture-advisor
Command: npx skills add https://github.com/MapleTechLabs/maple --skill clickhouse-architecture-advisor-mapletechlabs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the guesswork of designing ClickHouse systems by providing workload-specific architecture guidance instead of generic one-size-fits-all rules, ensuring your ingestion, partitioning, and query patterns are optimized for your exact use case.

Core Features & Use Cases

  • Workload Classification: Automatically categorizes your use case (observability, SIEM, financial services, IoT, etc.) to tailor recommendations.
  • Decision Frameworks: Provides structured guidance for ingestion strategy, time-series partitioning, enrichment path selection, late-arriving data handling, and real-time pre-aggregation.
  • Provenance-Labeled Recommendations: Every recommendation is explicitly marked as official (backed by ClickHouse documentation), derived (logically reasoned from official docs), or field (experience-based heuristics) to ensure transparency.
  • Use Case Example: Use this Skill to design a high-throughput observability ClickHouse architecture that handles 300K events per second with sub-second freshness, including Kafka-based decoupled ingestion and incremental materialized views for dashboard rollups.

Quick Start

Use the clickhouse-architecture-advisor skill to design a ClickHouse architecture for your real-time market surveillance workload that handles 80 million daily order events with support for late-arriving corrections and cancellations.

Frequently Asked Questions about clickhouse-architecture-advisor

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

FAQPage Schema
How do I choose the right ClickHouse ingestion strategy for high-throughput real-time workloads?

ClickHouse ingestion strategy selection depends on your workload classification and throughput requirements. This Skill provides decision frameworks for decoupled ingestion patterns like Kafka-based pipelines, tailored to your specific use case scale.

What is the best way to partition time-series data in ClickHouse for observability and SIEM workloads?

Time-series partitioning in ClickHouse requires workload-specific rules rather than generic defaults. The Skill delivers provenance-labeled partitioning recommendations, translating official documentation into target architectures for observability and SIEM.

How does ClickHouse handle late-arriving data corrections in financial services architectures?

ClickHouse handles late-arriving data corrections through workload-aware architecture decisions. This Skill provides decision frameworks for late-arriving data handling, ensuring your financial services system supports corrections and cancellations.

When should I use pre-aggregation and materialized views for real-time ClickHouse dashboards?

Pre-aggregation and incremental materialized views in ClickHouse are recommended when designing dashboards requiring sub-second freshness. The Skill outlines when to apply real-time pre-aggregation based on specific observability workload patterns.

Can I get ClickHouse architecture recommendations for specific IoT and financial workloads instead of generic rules?

Yes, this Skill provides workload-aware architecture guidance for ClickHouse, categorizing use cases like IoT and financial services. It delivers provenance-labeled recommendations with example DDL and validation steps instead of one-size-fits-all rules.

What enrichment path should I choose for my ClickHouse system design?

Choosing a ClickHouse enrichment path requires evaluating your specific real-time workload requirements. The Skill provides structured decision frameworks to select the optimal enrichment path, backed by official documentation and field heuristics.