Publishing an analysis from Claude Code

The whole point of this site is that publishing is cheap. Here is the entire loop, start to finish.

1. Write the analysis as Markdown

Add a file under src/content/posts/. The filename becomes the URL — my-analysis.md → /posts/my-analysis/. Every post starts with a small frontmatter block:

---
title: 'A clear, specific title'
description: 'One sentence shown on the homepage and in the RSS feed.'
date: 2026-06-15
tags: ['ai', 'data']
draft: false
---

Your analysis goes here. Plain Markdown — headings, lists, tables,
code blocks, blockquotes all work.

Only title and date are required. Set draft: true while you are still working — drafts are skipped when the site builds.

2. Ask Claude Code to do it for you

In practice I rarely write the file by hand. The prompt is roughly:

Take the analysis we just did and save it as a post in src/content/posts/. Pick a slug, fill in the frontmatter, and use today’s date.

Then to see it locally:

npm run dev

3. Push, and it’s live

git add .
git commit -m "Add: <the analysis>"
git push

Cloudflare Pages sees the push, rebuilds, and the new post is on shuaiguan.io within a minute. No deploy step to run by hand.

The mental model

You do	Happens automatically
Write .md	Validated against the schema
git push	Cloudflare rebuilds the site
—	RSS + sitemap regenerate

That is it. The friction is low enough that an analysis worth keeping is worth publishing.