CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

Data Platform Design — a Jekyll static blog at dataplatformdesign.com focused on data platform architecture, engineering, and best practices.

Tech Stack

• Framework: Jekyll (static site generator)
• Theme: minimal-mistakes (dark skin), via mmistakes/minimal-mistakes remote theme
• Hosting: GitHub Pages (github-pages gem)

Common Commands

# Serve locally
bundle exec jekyll serve

# Build
bundle exec jekyll build

# Install dependencies
bundle install

Note: _config.yml changes require restarting the server — they are not hot-reloaded.

Blog Post Conventions

• Files in _posts/ follow the naming pattern: YYYY-MM-DD-slug.md
• All posts use layout: default (not post) — using post will break rendering
• Required front matter fields: layout, title, date, author: Peter, categories
• Content covers data platform topics: medallion architecture, CI/CD, platform engineering, code control

Front matter template

---
layout: default
title: "Post Title"
date: YYYY-MM-DD HH:MM:SS +0000
author: Peter
categories: [category1, category2]
---