Time Series Forecasting — Modern Patterns & Production Best Practices
Modern Best Practices (2024-2025):
- Tree-based methods (LightGBM) deliver best performance + efficiency
- Transformers excel at long-term dependencies but watch for distribution shifts
- Future-Guided Learning: 44.8% AUC-ROC improvement in event forecasting
- Explainability critical in healthcare/finance (use LightGBM + SHAP)
This skill provides operational, copy-paste-ready workflows for forecasting with recent advances: TS-specific EDA, temporal validation, lag/rolling features, model selection, multi-step forecasting, backtesting, generative AI (Chronos, TimesFM), and production deployment with drift monitoring.
It focuses on hands-on forecasting execution, not theory.
When to Use This Skill
Claude should invoke this skill when the user asks for hands-on time series forecasting, e.g.:
- "Build a time series model for X."
- "Create lag features / rolling windows."
- "Help design a forecasting backtest."
- "Pick the right forecasting model for my data."
- "Fix leakage in forecasting."
- "Evaluate multi-horizon forecasts."
- "Use LLMs or generative models for TS."
- "Set up monitoring for a forecast system."
- "Implement LightGBM for time series."
- "Use transformer models (TimesFM, Chronos) for forecasting."
- "Apply Future-Guided Learning for event prediction."
If the user is asking about general ML modelling, deployment, or infrastructure, prefer:
- ai-ml-data-science - General data science workflows, EDA, feature engineering, evaluation
- ai-mlops - Model deployment, monitoring, drift detection, retraining automation
- ai-mlops - Security, privacy, governance for ML systems
If the user is asking about LLM/RAG/search, prefer:
- ai-llm - LLM fine-tuning, prompting, evaluation
- ai-rag - RAG pipeline design and optimization
- ai-rag - Search and retrieval systems
Quick Reference
| Task |
Tool/Framework |
Command |
When to Use |
| TS EDA & Decomposition |
Pandas, statsmodels |
seasonal_decompose(), df.plot() |
Identifying trend, seasonality, outliers |
| Lag/Rolling Features |
Pandas, NumPy |
df.shift(), df.rolling() |
Creating temporal features for ML models |
| Model Training (Tree-based) |
LightGBM, XGBoost |
lgb.train(), xgb.train() |
Tabular TS with seasonality, covariates |
| Deep Learning (Transformers) |
TimesFM, Chronos |
model.forecast() |
Long-term dependencies, complex patterns |
| Future-Guided Learning |
Custom RNN/Transformer |
Feedback-based training |
Event forecasting (44.8% AUC-ROC improvement) |
| Backtesting |
Custom rolling windows |
for window in windows: train(), test() |
Temporal validation without leakage |
| Metrics Evaluation |
scikit-learn, custom |
mean_absolute_error(), MAPE, MASE |
Multi-horizon forecast accuracy |
| Production Deployment |
MLflow, Airflow |
Scheduled pipelines |
Automated retraining, drift monitoring |
Decision Tree: Choosing Time Series Approach
User needs time series forecasting for: [Data Type]
├─ Strong Seasonality?
│ ├─ Simple patterns? → LightGBM with seasonal features
│ ├─ Complex patterns? → LightGBM + Prophet comparison
│ └─ Multiple seasonalities? → Prophet or TBATS
│
├─ Long-term Dependencies (>50 steps)?
│ ├─ Transformers (TimesFM, Chronos) → Best for complex patterns
│ └─ RNNs/LSTMs → Good for sequential dependencies
│
├─ Event Forecasting (binary outcomes)?
│ └─ Future-Guided Learning → 44.8% AUC-ROC improvement
│
├─ Intermittent/Sparse Data (many zeros)?
│ ├─ Croston/SBA → Classical intermittent methods
│ └─ LightGBM with zero-inflation features → Modern approach
│
├─ Multiple Covariates?
│ ├─ LightGBM → Best with many features
│ └─ TFT/DeepAR → If deep learning needed
│
└─ Explainability Required (healthcare, finance)?
├─ LightGBM → SHAP values, feature importance
└─ Linear models → Most interpretable
Navigation: Core Patterns
Time Series EDA & Data Preparation
- TS EDA Best Practices
- Frequency detection, missing timestamps, decomposition
- Outlier detection, level shifts, seasonality analysis
- Granularity selection and stability checks
Feature Engineering
- Lag & Rolling Patterns
- Lag features (lag_1, lag_7, lag_28 for daily data)
- Rolling windows (mean, std, min, max, EWM)
- Avoiding leakage, seasonal lags, datetime features
Model Selection
Forecasting Strategies
Validation & Evaluation
- Backtesting Patterns
- Rolling window backtest, expanding window
- Temporal train/validation split (no IID splits!)
- Horizon-wise metrics, segment-level evaluation
Generative & Advanced Models
- TS-LLM Patterns
- Chronos, TimesFM, Lag-Llama (Transformer models)
- Future-Guided Learning (44.8% AUC-ROC boost for events)
- Tokenization, discretization, trajectory sampling
Production Deployment
- Production Deployment Patterns
- Feature pipelines (same code for train/serve)
- Retraining strategies (time-based, drift-triggered)
- Monitoring (error drift, feature drift, volume drift)
- Fallback strategies, streaming ingestion, data governance
Navigation: Templates (Copy-Paste Ready)
Data Preparation
- TS EDA Template - Reproducible structure for time series analysis
- Resample & Fill Template - Handle missing timestamps and resampling
Feature Templates
- Lag & Rolling Features - Create temporal features for ML models
- Calendar Features - Business calendars, holidays, events
Model Templates
- Forecast Model Template - End-to-end forecasting pipeline (LightGBM, transformers, RNNs)
- Multi-Step Strategy - Direct, recursive, and seq2seq approaches
Evaluation Templates
- Backtest Template - Rolling window validation setup
- TS Metrics Template - MAPE, MAE, RMSE, MASE, pinball loss
Advanced Templates
- TS-LLM Template - Chronos, TimesFM, Future-Guided Learning implementation
Related Skills
For adjacent topics, reference these skills:
- ai-ml-data-science - EDA workflows, feature engineering patterns, model evaluation, SQLMesh transformations
- ai-mlops - Production deployment, automated monitoring (18-second drift detection), retraining pipelines
- ai-llm - Fine-tuning approaches applicable to time series LLMs (Chronos, TimesFM)
- ai-prompt-engineering - Prompt design patterns for time series LLMs
- data-sql-optimization - SQL optimization for time series data storage and retrieval
External Resources
See data/sources.json for curated web resources including:
- Classical methods (statsmodels, Prophet, ARIMA)
- Deep learning frameworks (PyTorch Forecasting, GluonTS, Darts, NeuralProphet)
- Transformer models (TimesFM, Chronos, Lag-Llama, Informer, Autoformer)
- Anomaly detection tools (PyOD, STUMPY, Isolation Forest)
- Feature engineering libraries (tsfresh, TSFuse, Featuretools)
- Production deployment (Kats, MLflow, sktime)
- Benchmarks and datasets (M5 Competition, Monash Time Series, UCI)
Usage Notes
For Claude:
- Activate this skill for hands-on forecasting tasks, feature engineering, backtesting, or production setup
- Start with Quick Reference and Decision Tree for fast guidance
- Drill into resources/ for detailed implementation patterns
- Use templates/ for copy-paste ready code
- Always check for temporal leakage (future data in training)
- Prefer LightGBM for most use cases unless long-term dependencies require Transformers
- Emphasize explainability for healthcare/finance domains
- Monitor for data distribution shifts in production
Key Principle: Time series forecasting is about temporal structure, not IID assumptions. Use temporal validation, avoid future leakage, and choose models based on horizon length and data characteristics.
1---2name: ai-ml-timeseries-23description: Operational patterns, templates, and decision rules for time series forecasting (modern best practices): tree-based methods (LightGBM), deep learning (Transformers, RNNs), future-guided learning, temporal validation, feature engineering, generative TS (Chronos), and production deployment. Emphasizes explainability, long-term dependency handling, and adaptive forecasting.4---56# Time Series Forecasting — Modern Patterns & Production Best Practices78**Modern Best Practices (2024-2025):**910- Tree-based methods (LightGBM) deliver best performance + efficiency11- Transformers excel at long-term dependencies but watch for distribution shifts12- Future-Guided Learning: 44.8% AUC-ROC improvement in event forecasting13- Explainability critical in healthcare/finance (use LightGBM + SHAP)1415This skill provides **operational, copy-paste-ready workflows** for forecasting with recent advances: TS-specific EDA, temporal validation, lag/rolling features, model selection, multi-step forecasting, backtesting, generative AI (Chronos, TimesFM), and production deployment with drift monitoring.1617It focuses on **hands-on forecasting execution**, not theory.1819---2021## When to Use This Skill2223Claude should invoke this skill when the user asks for **hands-on time series forecasting**, e.g.:2425- "Build a time series model for X."26- "Create lag features / rolling windows."27- "Help design a forecasting backtest."28- "Pick the right forecasting model for my data."29- "Fix leakage in forecasting."30- "Evaluate multi-horizon forecasts."31- "Use LLMs or generative models for TS."32- "Set up monitoring for a forecast system."33- "Implement LightGBM for time series."34- "Use transformer models (TimesFM, Chronos) for forecasting."35- "Apply Future-Guided Learning for event prediction."3637If the user is asking about **general ML modelling, deployment, or infrastructure**, prefer:3839- [ai-ml-data-science](../ai-ml-data-science/SKILL.md) - General data science workflows, EDA, feature engineering, evaluation40- [ai-mlops](../ai-mlops/SKILL.md) - Model deployment, monitoring, drift detection, retraining automation41- [ai-mlops](../ai-mlops/SKILL.md) - Security, privacy, governance for ML systems4243If the user is asking about **LLM/RAG/search**, prefer:4445- [ai-llm](../ai-llm/SKILL.md) - LLM fine-tuning, prompting, evaluation46- [ai-rag](../ai-rag/SKILL.md) - RAG pipeline design and optimization47- [ai-rag](../ai-rag/SKILL.md) - Search and retrieval systems4849---5051## Quick Reference5253| Task | Tool/Framework | Command | When to Use |54|------|----------------|---------|-------------|55| TS EDA & Decomposition | Pandas, statsmodels | `seasonal_decompose()`, `df.plot()` | Identifying trend, seasonality, outliers |56| Lag/Rolling Features | Pandas, NumPy | `df.shift()`, `df.rolling()` | Creating temporal features for ML models |57| Model Training (Tree-based) | LightGBM, XGBoost | `lgb.train()`, `xgb.train()` | Tabular TS with seasonality, covariates |58| Deep Learning (Transformers) | TimesFM, Chronos | `model.forecast()` | Long-term dependencies, complex patterns |59| Future-Guided Learning | Custom RNN/Transformer | Feedback-based training | Event forecasting (44.8% AUC-ROC improvement) |60| Backtesting | Custom rolling windows | `for window in windows: train(), test()` | Temporal validation without leakage |61| Metrics Evaluation | scikit-learn, custom | `mean_absolute_error()`, MAPE, MASE | Multi-horizon forecast accuracy |62| Production Deployment | MLflow, Airflow | Scheduled pipelines | Automated retraining, drift monitoring |6364---6566## Decision Tree: Choosing Time Series Approach6768```text69User needs time series forecasting for: [Data Type]70 ├─ Strong Seasonality?71 │ ├─ Simple patterns? → LightGBM with seasonal features72 │ ├─ Complex patterns? → LightGBM + Prophet comparison73 │ └─ Multiple seasonalities? → Prophet or TBATS74 │75 ├─ Long-term Dependencies (>50 steps)?76 │ ├─ Transformers (TimesFM, Chronos) → Best for complex patterns77 │ └─ RNNs/LSTMs → Good for sequential dependencies78 │79 ├─ Event Forecasting (binary outcomes)?80 │ └─ Future-Guided Learning → 44.8% AUC-ROC improvement81 │82 ├─ Intermittent/Sparse Data (many zeros)?83 │ ├─ Croston/SBA → Classical intermittent methods84 │ └─ LightGBM with zero-inflation features → Modern approach85 │86 ├─ Multiple Covariates?87 │ ├─ LightGBM → Best with many features88 │ └─ TFT/DeepAR → If deep learning needed89 │90 └─ Explainability Required (healthcare, finance)?91 ├─ LightGBM → SHAP values, feature importance92 └─ Linear models → Most interpretable93```9495---9697## Navigation: Core Patterns9899### Time Series EDA & Data Preparation100101- **[TS EDA Best Practices](resources/ts-eda-best-practices.md)**102 - Frequency detection, missing timestamps, decomposition103 - Outlier detection, level shifts, seasonality analysis104 - Granularity selection and stability checks105106### Feature Engineering107108- **[Lag & Rolling Patterns](resources/lag-rolling-patterns.md)**109 - Lag features (lag_1, lag_7, lag_28 for daily data)110 - Rolling windows (mean, std, min, max, EWM)111 - Avoiding leakage, seasonal lags, datetime features112113### Model Selection114115- **[Model Selection Guide](resources/model-selection-guide.md)**116 - Decision rules: Strong seasonality → LightGBM, Long-term → Transformers117 - Benchmark comparison: LightGBM vs Prophet vs Transformers vs RNNs118 - Explainability considerations for mission-critical domains119120- **[LightGBM TS Patterns](resources/lightgbm-ts-patterns.md)** *(2024-2025 best practices)*121 - Why LightGBM excels: performance + efficiency + explainability122 - Feature engineering for tree-based models123 - Hyperparameter tuning for time series124125### Forecasting Strategies126127- **[Multi-Step Forecasting Patterns](resources/multistep-forecasting-patterns.md)**128 - Direct strategy (separate models per horizon)129 - Recursive strategy (feed predictions back)130 - Seq2Seq strategy (Transformers, RNNs for long horizons)131132- **[Intermittent Demand Patterns](resources/intermittent-demand-patterns.md)**133 - Croston, SBA, ADIDA for sparse data134 - LightGBM with zero-inflation features (modern approach)135 - Two-stage hurdle models, hierarchical Bayesian136137### Validation & Evaluation138139- **[Backtesting Patterns](resources/backtesting-patterns.md)**140 - Rolling window backtest, expanding window141 - Temporal train/validation split (no IID splits!)142 - Horizon-wise metrics, segment-level evaluation143144### Generative & Advanced Models145146- **[TS-LLM Patterns](resources/ts-llm-patterns.md)**147 - Chronos, TimesFM, Lag-Llama (Transformer models)148 - Future-Guided Learning (44.8% AUC-ROC boost for events)149 - Tokenization, discretization, trajectory sampling150151### Production Deployment152153- **[Production Deployment Patterns](resources/production-deployment-patterns.md)**154 - Feature pipelines (same code for train/serve)155 - Retraining strategies (time-based, drift-triggered)156 - Monitoring (error drift, feature drift, volume drift)157 - Fallback strategies, streaming ingestion, data governance158159---160161## Navigation: Templates (Copy-Paste Ready)162163### Data Preparation164165- **[TS EDA Template](templates/timeseries/template-ts-eda.md)** - Reproducible structure for time series analysis166- **[Resample & Fill Template](templates/timeseries/template-resample-fill.md)** - Handle missing timestamps and resampling167168### Feature Templates169170- **[Lag & Rolling Features](templates/timeseries/template-lag-rolling.md)** - Create temporal features for ML models171- **[Calendar Features](templates/timeseries/template-calendar-features.md)** - Business calendars, holidays, events172173### Model Templates174175- **[Forecast Model Template](templates/timeseries/template-forecast-model.md)** - End-to-end forecasting pipeline (LightGBM, transformers, RNNs)176- **[Multi-Step Strategy](templates/timeseries/template-multistep-strategy.md)** - Direct, recursive, and seq2seq approaches177178### Evaluation Templates179180- **[Backtest Template](templates/timeseries/template-backtest.md)** - Rolling window validation setup181- **[TS Metrics Template](templates/timeseries/template-ts-metrics.md)** - MAPE, MAE, RMSE, MASE, pinball loss182183### Advanced Templates184185- **[TS-LLM Template](templates/timeseries/template-ts-llm.md)** - Chronos, TimesFM, Future-Guided Learning implementation186187---188189## Related Skills190191For adjacent topics, reference these skills:192193- **[ai-ml-data-science](../ai-ml-data-science/SKILL.md)** - EDA workflows, feature engineering patterns, model evaluation, SQLMesh transformations194- **[ai-mlops](../ai-mlops/SKILL.md)** - Production deployment, automated monitoring (18-second drift detection), retraining pipelines195- **[ai-llm](../ai-llm/SKILL.md)** - Fine-tuning approaches applicable to time series LLMs (Chronos, TimesFM)196- **[ai-prompt-engineering](../ai-prompt-engineering/SKILL.md)** - Prompt design patterns for time series LLMs197- **[data-sql-optimization](../data-sql-optimization/SKILL.md)** - SQL optimization for time series data storage and retrieval198199---200201## External Resources202203See [data/sources.json](data/sources.json) for curated web resources including:204205- Classical methods (statsmodels, Prophet, ARIMA)206- Deep learning frameworks (PyTorch Forecasting, GluonTS, Darts, NeuralProphet)207- Transformer models (TimesFM, Chronos, Lag-Llama, Informer, Autoformer)208- Anomaly detection tools (PyOD, STUMPY, Isolation Forest)209- Feature engineering libraries (tsfresh, TSFuse, Featuretools)210- Production deployment (Kats, MLflow, sktime)211- Benchmarks and datasets (M5 Competition, Monash Time Series, UCI)212213---214215## Usage Notes216217**For Claude:**218219- Activate this skill for hands-on forecasting tasks, feature engineering, backtesting, or production setup220- Start with [Quick Reference](#quick-reference) and [Decision Tree](#decision-tree-choosing-time-series-approach) for fast guidance221- Drill into resources/ for detailed implementation patterns222- Use templates/ for copy-paste ready code223- Always check for temporal leakage (future data in training)224- Prefer LightGBM for most use cases unless long-term dependencies require Transformers225- Emphasize explainability for healthcare/finance domains226- Monitor for data distribution shifts in production227228**Key Principle:** Time series forecasting is about temporal structure, not IID assumptions. Use temporal validation, avoid future leakage, and choose models based on horizon length and data characteristics.