// TODO(craig): name this blog▋

Don’t think about a pink elephant.

You just did. Your brain had to summon the elephant to know what not to think about. The instruction defeated itself.

Large language models have the same problem, except they can’t even try to comply.

How LLMs Process Text

When you write “don’t use jargon,” the model processes every token in that sentence. Including “jargon.” That token activates associations, weights, patterns learned from training data. The concept is now present in the context window, influencing what comes next.

This is an instructions file. It lives in your repository root. Your AI coding assistant reads it before touching your code.

You can call it CLAUDE.md or AGENTS.md or INSTRUCTIONS.md or whatever your tooling expects. The name doesn’t matter. What matters is that you’re encoding expectations that would otherwise live in your head.

What follows is a starting point. Steal it. Modify it. Delete the parts that don’t apply. Add the parts that do.

There’s a dirty secret about AI-assisted coding: it’s often too helpful.

Ask an AI to implement a feature and it will. Quickly. Confidently. It’ll reach across your codebase, modify whatever it needs, create new utilities that duplicate existing ones, and deliver working code that makes you slightly uncomfortable.

The code works. But it doesn’t belong.

After months of working with AI coding assistants, I’ve started to recognize the pattern. The AI isn’t bad at coding. It’s bad at not coding. It lacks the instinct that experienced developers have: the pause before typing, the “wait, where should this actually live?” moment, the awareness that every line you write exists in a larger context.

Hello, World.

World has not responded. I’ve checked. The void is, at time of writing, unnervingly silent. Perhaps World is busy. Perhaps World has better blogs to read. Perhaps World is a social construct, and I’m shouting into a server rack somewhere in Virginia.

This is my blog. I’m told every blog needs a first post, the way every program needs a main(). Something has to run first. Something has to break the silence. This is that something.