agents
AGENTS.md
Personal blog built with xertz. No tests or lint; Netlify builds and deploys on push.
New posts
- Always start a post with
npx xertz new "Title Words". It createsposts/<today>-<slug>/index.md. - The slug only lowercases and hyphenates spaces, so pass a title without punctuation, then set the real title in the
title:front matter. - Front matter is just
title:; layout comes fromposts/_config.yml. - Put images in the post folder and reference them relatively:
. - A
_prefix on a post folder keeps it out of the build (drafts). Older posts live inposts/archive/.
Preview
- Use the
blogpreview server from.claude/launch.json(npx xertz serveon port 8080). Never runxertz servein the foreground; it doesn’t exit. - It rebuilds on file changes. A post is served at
http://localhost:8080/<slug>/(the date prefix is dropped).