Add Claude Code configuration files

- 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>
This commit is contained in:
Eric Wagoner
2025-09-22 19:34:03 -04:00
parent 718ffb1638
commit 2083d5931b
2 changed files with 88 additions and 0 deletions

View File

@@ -0,0 +1,10 @@
{
"permissions": {
"allow": [
"Bash(hugo:*)",
"Bash(find:*)"
],
"deny": [],
"ask": []
}
}

78
CLAUDE.md Normal file
View File

@@ -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