vatt-ghern

Public personal tech blog. Daily news authored by a Claude routine. Bespoke HTML deep-stories, persona-driven editing, CJK typography, hosted on Cloudflare Pages.

Live: https://vatt-ghern.pages.dev
RSS: https://vatt-ghern.pages.dev/feed.xml
Codename: vatt'ghern (Elder Speech for "witcher")
Sibling: kaer-morhen (internal wiki — not a content source)

What's inside

Surface	What it is
`src/posts/YYYY/MM/DD/`	Bespoke HTML for one daily roundup + up to three deep-stories
`src/_includes/layouts/`	Nunjucks layouts (base, post, archetype)
`src/_includes/widgets/`	Reusable catalog widgets — summon with `{% widget "name" %}`; gallery at `/widgets/`
`src/_data/sources.yml`	45 priority-tiered sources the daily-news skill crawls
`skills/daily-news/`	Claude skill: persona, archetypes, source dispatcher, anti-dup
`commands/`	Slash commands: `/vatt-ghern:daily-news`, `:weekly`, `:monthly`
`mcp/`	Cloudflare Worker exposing the archive over MCP
`scripts/`	Build helpers (OG image, today.svg card, sigil)

Setup

nvm use            # node 20 per .nvmrc
npm install
npm run dev        # http://localhost:8080

Build

npm run build      # writes _site/  (runs prebuild: OG + today.svg)
npm run lint:html  # validates _site/**/*.html
npm test           # node --test tests/*.mjs

Useful one-offs:

npm run og                                    # rebuild OG images
npm run card                                  # rebuild today.svg
npm run social                                # rebuild repo social preview
npm run sigil                                 # rebuild sigil webp variants
npm run widgets:catalog                       # refresh routine-facing widget-catalog.md from sidecars
npm run sources:list                          # list daily-news sources
npm run sources:dry-run -- --type=arxiv       # dry-fetch one source type

The repo's GitHub social preview image is src/static/social-preview.png (1280×640). After regenerating, upload via the GitHub web UI at Settings → Social preview.

Deploy

Cloudflare Pages auto-builds:

main → production at https://vatt-ghern.pages.dev
PR / non-main branch → preview build, URL posted as PR comment

GitHub Actions runs .github/workflows/quality.yml (build + html-validate) on every PR.

Daily news routine

The Claude routine (or /vatt-ghern:daily-news slash command) executes the daily-news skill which:

Loads context from the past 7 days of posts (dedup baseline)
Fetches from src/_data/sources.yml via scripts/fetch-all.mjs
Clusters cross-source variants and scores candidates
Picks today's 10 (domain coverage) + up to 3 deep-story clusters
Authors bespoke HTML for each, in parallel sub-agents
Runs the QA gate (archetype-check, html-validate, link-check, dedup)
Opens a PR for human review

Weekly + monthly rollups follow the same machinery via /vatt-ghern:weekly and /vatt-ghern:monthly.

MCP server

mcp/worker.mjs is a thin Cloudflare Worker that exposes the archive over MCP — list_posts, get_post, latest, search. See mcp/README.md for tool schemas and Claude Desktop config.

License

The MIT licence applies to all code and templates. Authored prose inside src/posts/** carries the author's voice — please credit if you quote at length.

Related docs

DESIGN.md — design rationale (typography, OKLCH palette, sigil)
PRODUCT.md — product vision, anti-references, pipeline notes
CONTRIBUTING.md — commit conventions, CJK typography rules
SECURITY.md — how to report vulnerabilities

Vatt Ghern

README