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.
ADRs
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.
Stop Betting on One-Shot: A Practical Workflow for Shipping with LLMs
LLMs don’t ship software. They ship text. You ship software by constraining the problem until text reliably becomes change sets you can trust.
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.