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.
Documentation
ADRs for AI-Assisted Codebases: Write Down Why, or the Agent Will Undo It
ADRs were written for the future engineer who asks ‘why is it like this?’ That engineer is now an AI agent, it arrives in minutes instead of years, and it doesn’t ask - it refactors.
Documenting System Design with Structurizr & ADRs
Discover how to integrate ‘architecture as code’ using Structurizr and Architecture Decision Records (ADRs) to maintain version-controlled, living documentation for cloud and microservices architectures.