From 0658459dfb1eeb17da06f1a6aabc97d28a6a163b Mon Sep 17 00:00:00 2001
From: Anton Vakhrushev <anwinged@ya.ru>
Date: Sat, 7 Mar 2026 11:54:59 +0300
Subject: [PATCH] Add claude.md

---
 CLAUDE.md | 41 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)
 create mode 100644 CLAUDE.md

diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..db0b434
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,41 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Personal homepage for [vakhrushev.me](https://vakhrushev.me) — a static site built with Astro 5, Tailwind CSS 4, and Vue 3. Russian-language content. All development runs inside Docker containers; npm is not used on the host.
+
+## Commands
+
+All commands use [Taskfile](https://taskfile.dev/) and run through Docker:
+
+- `task build-docker` — build the Node Docker image (required first-time setup)
+- `task install` — install npm dependencies (inside Docker)
+- `task dev` — start dev server at `http://localhost:4321`
+- `task build-prod` — production build (outputs to `dist/`)
+- `task deploy` — full deploy pipeline: build → Docker nginx image → Ansible to server
+- `task npm -- <args>` — run arbitrary npm commands inside Docker
+
+## Architecture
+
+**Static site generator**: Astro 5 with MDX, Vue, and Sitemap integrations. Tailwind CSS 4 via Vite plugin.
+
+**Layouts** (three-level hierarchy):
+- `BaseLayout.astro` — HTML shell, meta tags, Google Fonts, Yandex Metrika
+- `InternalLayout.astro` → extends BaseLayout, adds navigation and page container
+- `ArticleLayout.astro` → extends InternalLayout, adds article title and date
+
+**Content**: Articles live in `src/content/articles/` as `.md`/`.mdx` files. Date is parsed from filename (`YYYY-MM-DD-slug.md`), not stored in frontmatter. Schema defined in `src/content.config.ts`.
+
+**Pages**: `src/pages/` — index, articles list, `[slug]` dynamic article pages, gallery, 404, RSS feed (`rss.xml.ts`).
+
+**Interactive component**: `PredictorDemo.vue` — Vue 3 island (`client:visible`) embedded in the predictor article via MDX. Uses `@anwinged/predictor` package.
+
+**Utilities**: `src/utils/articles.ts` — `parseDateFromId()` extracts date from article filename ID.
+
+**Styles**: `src/styles/global.css` — Tailwind 4 with custom theme (PT Serif font, 740px content width, GitHub-inspired colors).
+
+## Deployment
+
+Production builds into a Docker nginx image (`docker/Dockerfile.nginx.prod`), deployed via Ansible from a separate `pet-project-server` repo. The deploy task tags images with `git-hash-timestamp`.