Open it when: the site is ready to go live, or ready to hand to someone else.
The hosting detail lives in Pattern: putting a site up on Cloudflare. This drawer only holds what the design sources and our build add.
What we know
Before it goes live
- Without an automatic checker running on every edit, run impeccable's rule checker once at the end. A build that skips it ships every tell the checker exists to catch. [impeccable]
- Fix a script error before judging anything else. The rule checker flags it as an error. [impeccable]
- Check that no image is broken or empty. [impeccable]
- Every image you ship should carry the prompt that made it, or where it came from. [impeccable]
Deploying
- One deploy path per site. When two machines both deployed the same site, a deploy from an out-of-date copy quietly put an older version back live. [our build]
- Pull the latest before any work. Deploy only by pushing, so GitHub Actions does it. [our build]
- When you swap in a real photo, give it a new file name. Images are usually cached for a year, so a returning visitor keeps the old one under the old name. [our build]
- Cloudflare's own traps (headers that add up, caching, checking the right address) are in Pattern: putting a site up on Cloudflare. [our build]
Handing it to someone who isn't technical
- They'll change it by talking to their own AI. So give that AI a CLAUDE.md in the repo. [our build]
- The CLAUDE.md says what to read first, that "publish it" means commit and push, never to deploy by hand, which words the owner never uses, and that a fact marked unconfirmed is never stated as fact. [our build]
- Astryx's
initwrites its component list into AGENTS.md or CLAUDE.md, so the next AI knows the parts. [Astryx]
Tools in this drawer
- Tool: rule checker for AI tells (impeccable detect). Pick it for the last scan before you push.
- Tool: technical audit (impeccable audit). Pick it when you want a ranked list of what must be fixed before release.
- Tool: Astryx for agents (CLI and MCP server). Pick it when the site is built on Astryx and the next person's AI must keep using it correctly.