CLAUDE.md

This file guides Claude Code (and other AI coding agents) when working in this repository.

All agent-facing guidance lives in AGENTS.md — read it first. It covers:

• The environment (no local Ruby/Node; build inside Docker with ruby:3.3; why the theme’s docker/ compose files don’t work here).
• How to build and preview the site locally, and how to verify a successful build.
• Key site facts: permalink: date, the Snowflake skin, the decoupled tab title vs. banner, and where browser/OS chrome colors live.
• The _temp_resources/ → post workflow: how to turn the owner’s staged raw material into a published post under _posts/ + postresources/.
• Commit conventions (branch off main; commit only when asked).

Human-facing documentation: README.md (English) and README-zh.md (中文).

Quick reference

• Preview: see the Docker command in AGENTS.md; open http://localhost:4000.
• Add a post from staged material: follow the _temp_resources → post workflow.
• Deploy: push to main; GitHub Pages publishes automatically.

</content>