Matt Stockton

Notes Software engineering

Give the models concise engineering principles

I've said to let the models breathe more and be less prescriptive. Lauren Tan put a more coherent version of that into words: encode tried-and-true engineering principles as concisely as possible, so the model can use what it already knows.

Knowing those principles takes experience and often some battle scars. Classical software engineering skills still matter because they help you recognize when one of those insights will make a big difference in steering the model.

What I would add now: In November, I added a more specific version of this: when a model makes the same mistake repeatedly, add the generalized principle to AGENTS.md. Don't keep adding a rule for every little detail. If the model can figure something out by reading the codebase, you may not need to put it in the instructions at all. Read the newer note on X.

Originally posted on X. Lightly edited for reading here.