AGENTS.md

The sections every repository's AGENTS.md has, word for word. The rest of the file is the repository's own.

craftz

This repository follows craftz's rules, which set how every repository builds, checks, deploys and releases. Run pnpm craftz rules before changing any of that. It prints the rules for the version this repository installs, and pnpm craftz rules <id> prints one.

Change the toolchain, scripts, versions or deploys in craftz first, then bring each repository in line. Don't change them in one repository alone.
Open a pull request with pnpm pr "<title>". It branches from main, commits, runs pnpm run verify, pushes and turns on auto-merge, and the pull request is squash-merged once CI passes. Nobody pushes to main. After a merge, pnpm gone deletes the merged branches.
To see what's live, run pnpm craftz status. It reads CI on main, the open pull requests, the version on npm, and a site's latest build and addresses, and --log adds the build's log. Use it rather than reading GitHub, npm or Cloudflare another way.
In a package, give it one label for the release notes, pnpm pr "<title>" --label <label>: breaking, added, fixed, improved, docs, or internal for tests, tooling, site and lessons. CI fails without one.
Run tools through pnpm run … and pnpm exec, not global installs.
A held check is a tool's limit, not a choice. The rules give its reason, so leave it until the reason goes away.

Prose

Explanations go in @prose comments. Run pnpm prose rules before writing prose. It prints the rules for the version this repository uses, each with the codes that check it, and pnpm prose rules <code> says what one warning asks for. The rules live in prose's usage and aren't copied here, so every repository writes to the same rules.

After writing prose, run pnpm prose style <files> on the files you changed, and take its advice where it reads better. It always passes, so it's advice, not a check.