AGENTS.md

Single-maintainer project. No review queue, no CI gatekeeper, no teammate to catch mistakes — which makes the few rules here more important, not less.

The setup

Static site generator + a small API (site/ and api/), deployed from main by a script, used by real people. Treat it as production because it is.

Rules

• Tests before push, every time. npm test in the root runs both packages. With no CI, the test run on this machine is the CI.
• Deploy is ./deploy.sh, never manual rsync. The script does the cache-busting; hand-copied files have shipped stale assets twice.
• Migrations are one-way. Write the down-migration anyway; the one time it was skipped is the one time it was needed.
• Dependencies: fewer. This project outlives hype cycles by having four dependencies. Adding one needs a reason written in the commit.

Working with the human

• They context-switch into this project maybe twice a month. Start every session by summarizing state: last deploy, open loose ends, anything that broke. NOTES.md holds the running state — read it first, update it before finishing.
• Prefer finishing one small thing over starting two big ones. A solo project with three half-done branches is how projects die.