From 2083d5931b64ac7e37acb5a9dd019e599ea15f46 Mon Sep 17 00:00:00 2001
From: Eric Wagoner <ewagoner@gmail.com>
Date: Mon, 22 Sep 2025 19:34:03 -0400
Subject: [PATCH] Add Claude Code configuration files
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Add CLAUDE.md with project documentation for Claude Code
- Add .claude/settings.local.json with local settings
- These files help Claude Code understand the blog structure and provide better assistance

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 .claude/settings.local.json | 10 +++++
 CLAUDE.md                   | 78 +++++++++++++++++++++++++++++++++++++
 2 files changed, 88 insertions(+)
 create mode 100644 .claude/settings.local.json
 create mode 100644 CLAUDE.md

diff --git a/.claude/settings.local.json b/.claude/settings.local.json
new file mode 100644
index 00000000..a994a7a4
--- /dev/null
+++ b/.claude/settings.local.json
@@ -0,0 +1,10 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(hugo:*)",
+      "Bash(find:*)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}
\ No newline at end of file
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 00000000..45a74097
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,78 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+This is a personal blog built with Hugo static site generator. The site is deployed to https://blog.kestrelsnest.social and uses the "m10c" theme.
+
+## Common Commands
+
+### Development
+```bash
+# Start development server with drafts visible
+hugo server -D
+
+# Start development server without drafts
+hugo server
+
+# Kill existing Hugo server if port is in use
+pkill -f "hugo server"
+```
+
+### Building
+```bash
+# Build the site to public/ directory
+hugo
+
+# Build with drafts included
+hugo -D
+```
+
+### Deployment
+```bash
+# Deploy to production (builds and syncs to server)
+./deploy
+```
+
+The deploy script builds the site and uses rsync to sync the `public/` directory to the production server at `social:../../var/www/blog/www`. It uses the `--delete` flag to remove files on the server that aren't in the local public folder.
+
+### Content Management
+```bash
+# Create a new blog post
+hugo new posts/my-new-post.md
+
+# Create content using the default archetype
+hugo new content-name.md
+```
+
+## Architecture & Structure
+
+### Theme System
+The blog uses the "m10c" theme but has two additional themes available (henry, kestrel). Theme switching is done via `config.toml`.
+
+### Content Organization
+- `/content/posts/` - Blog posts
+- `/content/now.md` - "Now" page showing current activities
+- `/content/then.md` - "Past" page with historical content
+- `/content/upcoming.md` - "Future" page with upcoming events
+- `/content/mytweets.md` - Local tweet archive page
+
+### Menu Structure
+The site has four menu groups configured in `config.toml`:
+- **main**: Home and Tags navigation
+- **secondary**: Past, Now, Future pages
+- **tertiary**: Local Tweet Archive
+- **featured**: External links like the Random Recipe Project
+
+### Key Configuration
+- Base URL: https://blog.kestrelsnest.social
+- Author: Eric Wagoner
+- Social links are configured in `config.toml` under `params.social`
+- Default Open Graph image: `/static/default-og.png`
+
+## Important Notes
+
+- The Hugo server automatically watches for changes in `/archetypes`, `/assets`, `/content`, `/data`, `/layouts`, `/static`, and `/themes`
+- Posts are created with draft status by default (controlled by archetype)
+- The site integrates with multiple social platforms and services in the Kestrel's Nest ecosystem
\ No newline at end of file