3 posts
Writing for the machine
A CLAUDE.md is not a config file. Neither is an AGENTS.md or a Cursor rule. They are prompts, loaded into a context window, competing for attention with everything else in it. These posts are about what each one actually loads, and how to write lines a model will act on.
- CLAUDE.md examples that change the diffMost CLAUDE.md files are a list of things the author would like to be true. The ones that work read like instructions to a new colleague who takes everything literally.25 Sept 2026 · 7 min
- AGENTS.md vs CLAUDE.md: which one gets readThey are not rival standards, and you probably do not need to choose. What you do need to know is the resolution rule, because one stray file silently switches which one Claude reads.25 Sept 2026 · 6 min
- Cursor rules: what replaced .cursorrulesAlmost every .cursorrules example online was written for a format Cursor's documentation no longer describes. Here is the current shape, including the frontmatter table that decides whether a rule is ever loaded.25 Sept 2026 · 7 min
These are about instruction files. For the writing itself, the Academy takes one part of a prompt per lesson, and the guides work through a single job end to end.