About a month ago I wrote about stopping coding. The short version: Claude Code was my only development tool. I wrote no code by hand, and spent most of my time specifying workflows, checking outputs, and deciding what to try next. Since then I started working on ARC-AGI-2, and the agent got a brain. Thanks to Alessio and Raja for nudging me in that direction. Between the brain and stronger Codex models, I can give the agent much more autonomy because memory no longer has to live in the startup file. Less for me to remember. From One Big File to a BrainBack then, my CLAUDE.md grew into a large operating manual. But it also mixed two different things: instructions for how the agent should behave; documentation of what the project currently knew. Those are not the same thing. Instructions should be stable. Documentation changes constantly. The Claude Code docs are explicit about this: "target under 200 lines per CLAUDE.md file. Longer files consume more context and reduce adherence."…
No comments yet. Log in to reply on the Fediverse. Comments will appear here.