Dev notes on product & AI
Notes on building products and the AI workflows behind them.
Let the Build Enforce the Rule — Invariants for a Bilingual Static Site
Three rules that kept breaking in a docs file, moved into sixty lines of build hook — converting silent errors into loud failures.
CLAUDE.md Is a Contract, Not a README — Writing Rules an Agent Actually Follows
Adding rules made them less likely to be followed. What changed when we cut the file in half and kept only the judgment calls.
Scheduled Publishing on a Static Site — Making Time Pass Without a Server
Scheduled publishing on a site with no server to evaluate the request — the build-time filter, the daily rebuild, and the traps we walked into.
A folder structure that gives AI agents the whole product context
How we organize iOS, Android, Web, and planning documents in one parent workspace without giving up independent repositories.