zircote

CLAUDE.md

This file provides guidance to Claude Code when working with zircote.github.io.

Project Overview

Personal website and blog for Robert Allen (zircote) - technologist building AI-powered developer tools and precision agriculture systems. Built with Jekyll and enhanced with content-pipeline automation for validation, calendaring, and AI-assisted content creation.

Project Structure

.
├── _posts/                # Blog posts (Jekyll)
├── _projects/             # Project showcases
├── _docs/                 # Documentation pages
├── _layouts/              # Jekyll layouts
├── _includes/             # Jekyll partials
├── _data/                 # Site data (navigation, social, skills)
├── brands/                # Brand configuration
│   └── zircote/           # Personal brand profile
├── calendar/              # Editorial calendar (YAML)
├── content/               # Content staging
│   ├── social/            # Social media posts
│   └── video/             # Video scripts
├── prompts/               # AI generation prompts
├── schemas/               # Validation schemas
├── scripts/               # Validation scripts
├── templates/             # Content templates
└── _config.yml            # Jekyll configuration

Build Commands

# Local development
bundle exec jekyll serve

# Build for production
bundle exec jekyll build

# Content validation
npm run validate
npm run lint:md
npm run lint:links
npm run lint:frontmatter
npm run lint:seo

Brand: zircote

Author: Robert Allen Focus: Technology, Development, Agriculture Tech URL: https://www.zircote.com

Color Palette

| Color | Hex | Usage | |——-|—–|——-| | Rust/Terracotta | #8E4432 | Primary accent, links, headings | | Muted Purple | #74657E | Secondary accent | | Dusty Rose | #CAA094 | Highlights | | Charcoal | #4A4A4A | Text | | Off-White | #F9F3F4 | Background |

Content Pillars

Content Creation Workflow

Blog Posts

  1. Create in _posts/ with naming: YYYY-MM-DD-slug.md
  2. Use Jekyll frontmatter format:
---
layout: post
title: "Post Title"           # 50-60 chars for SEO
date: 2025-01-15
categories: [category1, category2]
tags: [tag1, tag2, tag3]
excerpt: "Description"        # 150-160 chars
comments: true
---
  1. Writing guidelines:
    • Minimum 1000 words for SEO
    • Lead with main insight
    • Use H2 for major sections
    • Include code examples
    • End with CTA

Projects

Create in _projects/ with format:

---
layout: project
title: "Project Name"
description: "Brief description"
github: "zircote/repo-name"
status: active              # active, maintained, archived
tags: [tag1, tag2]
featured: true
---

Documentation

Create in _docs/ for comprehensive guides.

AI-Assisted Content Generation

Use prompts from prompts/ and brands/zircote/templates/:

# Blog post generation
cat brands/zircote/templates/blog-post.prompt.md

# Release notes
cat brands/zircote/templates/release-notes.prompt.md

# Social media adaptation
cat prompts/blog-to-social.prompt.md

Editorial Calendar

Check calendar/ for planning:

cat calendar/2025-Q1.yml

Calendar format:

quarter: "2025-Q1"
months:
  january:
    posts:
      - week: 1
        type: blog
        title: "Post Title"
        status: draft
        due_date: 2025-01-07

Validation Pipeline

GitHub Actions workflows in .github/workflows/:

Content Quality Checklist

Before Drafting

Before PR

Naming Conventions

Files

Branches

Commits

SEO Guidelines

Priority projects for content and updates:

Integration Notes