Assume the Agent Read Your .env

Assume the Agent Read Your .env

Anything in your working directory or shell can end up in a coding agent's transcript, and transcripts get synced and shared. Make what the agent reads useless to anyone else.

Write for the Agent That Will Read Your Repo

Write for the Agent That Will Read Your Repo

An AGENTS.md file has a reader that acts on what it says. That changes what belongs in it: commands that work, the traps, what never to touch, and very little else.

Keep the Hard Parts

Keep the Hard Parts

AI makes you faster at what you already understand. The judgment you use to steer it and check its work comes from doing hard things yourself, so keep a few of them on purpose.

Ship Software That Explains Its Own Failures

Ship Software That Explains Its Own Failures

When software you ship breaks on a machine you don't run, it usually goes quiet, and quiet looks the same as switched off. The software has to keep its own record and report it later.