CLAUDE.md

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

Commands

bundle install              # Install Ruby dependencies
bundle exec jekyll serve    # Run local dev server (http://localhost:4000)
bundle exec jekyll build    # Build static site to _site/

Architecture

This is a Jekyll-based personal site hosted on GitHub Pages using the Minimal Mistakes remote theme.

Content Model

Posts live in _posts/{YEAR}/ and follow a link-aggregator pattern — each post is a brief description pointing to external content (podcasts, webinars, IBM redbooks, conference replays). The link: frontmatter key sets the post’s canonical external URL.

Standard post frontmatter:

---
title: "Post Title"
categories:
  - Blog       # or Tutorial, Video
tags:
  - Ansible
  - z/OS
link: https://external-url.com
---
Brief description...

[Link text](https://external-url.com)

Key Files

File Purpose
_config.yml Jekyll config, theme settings, permalink structure (/:categories/:title/)
_data/navigation.yml Main nav menu — edit here to add/remove nav links
_pages/speaking_events_archive.md Manually maintained table of 40+ speaking events at /talks/
_includes/analytics-providers/custom.html Google Analytics (GA4: G-H7TKVPFGBG) override

Speaking Events Page

_pages/speaking_events_archive.md is a hand-maintained Markdown table (not a data-driven collection). When adding new talks, append rows to the table with: date, event name, session title, and replay/slides links.

Theme Defaults

Post defaults (set in _config.yml):