CLAUDE.md — johncderrick.com

Project Overview

Jekyll-powered static site. Blog posts are hand-authored HTML files with YAML frontmatter in /logs/. All index pages, RSS feeds, and curated lists are manually maintained (not auto-generated).

New Log Post Checklist

Every time a new log post is created, the following files must be updated:

Always Required

1. Create the post file — New .html file in /logs/ with proper frontmatter (layout: post, title, description, permalink, post_title, date, subject, suggested_reads).

2. /logs/index.html — Add a new <div class="blog-entry"> block at the top of the list (entries are sorted newest-first). Update the data-categories attribute to match the post’s categories. Also update the category counts in the category filter buttons (e.g., “All”, “AI & Agentic Systems”, etc.).

3. /logs/feed.xml — Add a new <item> entry at the top of the main RSS feed. Update the <lastBuildDate> in the channel header.

Conditionally Required (by category)

1. /logs/feed-tech.xml — Add item if the post covers AI, engineering, or business topics. Update <lastBuildDate>.

2. /logs/feed-autism.xml — Add item if the post covers autism or neurodivergence topics. Update <lastBuildDate>.

3. /logs/feed-philosophy.xml — Add item if the post covers philosophy, identity, or consciousness topics. Update <lastBuildDate>.

4. /logs/feed-history.xml — Add item if the post covers history or artifacts topics. Update <lastBuildDate>.

5. /goldtism.html — If the post is autism/neurodivergence-related, add it to “The Logs” section with a <a class="goldtism-log-item"> entry including title and description.

RSS Item Format

<item>
    <title>Post Title</title>
    <link>https://www.johncderrick.com/logs/post-slug</link>
    <guid>https://www.johncderrick.com/logs/post-slug</guid>
    <pubDate>Sat, 28 Mar 2026 09:00:00 EST</pubDate>
    <description>Brief description of the post.</description>
</item>

Blog Entry Format (index.html)

<div class="blog-entry" data-categories="ai business">
    <div class="blog-date">Mar 28, 2026</div>
    <div class="blog-title">
        <a href="/logs/post-slug">Post Title</a>
    </div>
    <div class="blog-subject">AI · Business · Strategy</div>
</div>

Category Mapping