Skip to content

CLAUDE.md

Latest commit

 

History

History
73 lines (53 loc) · 2.68 KB

CLAUDE.md

File metadata and controls

73 lines (53 loc) · 2.68 KB

CLAUDE.md

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

Project Overview

This is a Jekyll-based blog/portfolio site using the Minimal Mistakes remote theme. The site showcases technical articles on data engineering, machine learning, software architecture, and related topics.

Site Architecture

  • Static Site Generator: Jekyll with GitHub Pages
  • Theme: Minimal Mistakes (remote theme)
  • Content Structure:
    • _posts/ - Blog posts in markdown format with YAML front matter
    • _pages/ - Static pages (About, Projects, Archives, etc.)
    • _data/ - Site configuration data (navigation, etc.)
    • _includes/ - Template partials and custom HTML
    • assets/ - Images, CSS, and other static assets
    • _site/ - Generated site output (ignored in git)

Post Format

Blog posts follow Jekyll conventions:

  • File naming: YYYY-MM-DD-title-slug.md
  • YAML front matter includes: title, date, categories, author
  • Content uses GitHub-flavored markdown with kramdown
  • Posts may include draw.io diagrams (.drawio files) and exported images (.drawio.png)

Common Development Commands

Local Development

# Install dependencies
bundle install

# Serve site locally with live reload
bundle exec jekyll serve

# Serve with drafts visible
bundle exec jekyll serve --drafts

# Build site without serving
bundle exec jekyll build

Working with Diagrams

The site uses draw.io diagrams embedded in posts. When creating or updating diagrams:

  • Store .drawio source files in _posts/ directory alongside related posts
  • Export to PNG using draw.io.export <diagram>.drawio (creates .drawio.png)
  • Reference exported images in markdown: ![](/path/to/diagram.drawio.png)
  • Follow diagram styling from ~/.claude/CLAUDE.md (rounded boxes, Sketch style, gradients)

Content Guidelines

  • Technical posts should be informative and approachable (see existing posts for tone)
  • Include relevant images and diagrams to support explanations
  • Use proper categorization for posts (data-engineering, machine learning, architecture, etc.)
  • Posts cover topics: Python, scikit-learn, PySpark, FastAPI, AWS CDK, architecture patterns

Site Configuration

  • Main config: _config.yml
  • Navigation: _data/navigation.yml
  • Author info, social links, and site metadata in _config.yml:62-107
  • Default post layout includes: author profile, read time, comments, sharing, related posts

Theme Customization

  • Skin: "dirt" (defined in _config.yml:30)
  • Custom includes in _includes/head/ for additional head elements
  • Site uses pagination (5 posts per page)
  • Archive pages generated via liquid templates (by year, category, tag)