Data Pipeline Design

Data Pipeline Design

Design robust, maintainable data pipelines that reliably move, transform, and validate data at scale.

Context

You are designing data pipelines (batch or streaming). Plan data flow, transformations, quality gates, failure recovery, and monitoring. Read source systems, target requirements, latency expectations, and volume projections.

Domain Context

Based on modern data engineering practices (Spark, Airflow, Kafka, Beam):

• Batch Pipelines: Scheduled jobs (hourly, daily); high throughput, moderate latency
• Streaming Pipelines: Continuous ingestion; low latency, higher operational complexity
• Micro-batching: Spark Streaming; lower latency than batch, simpler than true streaming
• Orchestration: DAG-based scheduling (Airflow, dbt) for complex multi-stage pipelines
• Observability: Monitor latency, throughput, data quality, freshness

Instructions

1. Choose Processing Model: Batch (daily jobs?) or streaming (realtime features?)? Hybrid (Lambda: batch + streaming for both speed and accuracy)? Consider latency SLA and cost.

1. Design Data Stages: Raw ingestion (as-is from source) → Bronze. Cleansing and normalization → Silver. Business logic and enrichment → Gold. This layered medallion architecture separates concerns.

1. Implement Quality Gates: Validation at each stage. Fail pipeline if data quality drops. Track anomalies: unexpected null rates, value distributions, cardinality changes.

1. Handle Failures and Recovery: Idempotent transformations allow safe retries. Checkpoint state for streaming pipelines; resume from last checkpoint on failure. Use dead-letter queues for unparseable records.

1. Plan Monitoring and Alerting: Track freshness (when was last successful run?), latency (time from source to sink), volume (record counts by stage), error rates. Alert on anomalies and SLA misses.

Anti-Patterns

• No Data Quality Checks: Assume data from source is clean. Result: garbage in, garbage out. Guard: Validate at ingestion; alert on schema changes or anomalies.
• Tightly Coupled Transformations: Pipeline is monolithic script. Result: hard to test, reuse, debug. Guard: Break into modular stages; each stage is independently testable.
• No Checkpoint/Recovery: Assume pipelines always succeed. Result: gaps in data, lost work. Guard: Checkpoint state; design for idempotent retries.
• Ignoring Operational Overhead: Streaming pipelines look simple at 1MB/s, collapse at 1GB/s. Result: unexpected scaling headaches. Guard: Load-test pipelines; plan infrastructure for 10x growth.

Further Reading

• Fundamentals of Data Engineering by Joe Reis and Matt Housley — modern pipeline design
• The Data Warehouse Toolkit by Ralph Kimball — medallion/dimensional modeling
• Apache Airflow Guide — orchestration patterns

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: sethdford
• Source: sethdford/claude-skills
• License: MIT

Install and usage instructions live in the source repository linked above.