24
I've realised that AGENTS.md / CLAUDE.md solve two distinct problems:
* It tells the LLM the conventions of the project, avoiding follow-up prompts.
* It precomputes a summary of the project, saving a bunch of searches at the start of a session.
miniblog.
Related Posts
TIL rustc has a style guide for suggestions! https://rustc-dev-guide.rust-lang.org/diagnostics.html#suggestion-style-guide
They recommend avoiding 'did you mean' or 'the following' in favour of direct suggestions and highlighted positions.
Contrasting the C++ committee with Rust's RFC process, and avoiding antagonistic design evaluation:
The Rise of the Stupid Network: a remarkable 1997 essay on what ISPs as dumb bit pipes enables, moving innovation to client devices on the internet, and avoiding the scarcity mindset from when hardware was expensive:
https://www.hyperorg.com/misc/stupidnet.html