A hand holding a typed index card at the front of an open library card catalog drawer

What Goes in CLAUDE.md, and What Belongs in an ADR

You read the previous post and pasted the why into CLAUDE.md, and now that paragraph rides along on every task the agent ever runs. The sign belongs there. The reason doesn’t.

September 9, 2026 · 8 min · Vladimir Cvetić