The latest articles on DEV Community by Thomas Knee (@tom-at-align). https://dev.to/tom-at-align https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4241379%2Fb6a64e23-f441-4ea1-a812-ab4e851515d3.png https://dev.to/tom-at-align en Thomas Knee Thu, 12 Nov 2026 15:35:11 +0000 https://dev.to/tom-at-align/my-coding-agent-kept-undoing-things-wed-already-decided-1od5 https://dev.to/tom-at-align/my-coding-agent-kept-undoing-things-wed-already-decided-1od5 <p>Coding agents are good at reading code. They're bad at knowing why the code is like that.</p> <p>The why is usually somewhere else. A ticket where someone explained the edge case. A PR comment saying "we tried this, it broke billing". A Slack thread where the team picked Postgres over Mongo. The agent never sees any of it, so it "simplifies" the weird condition, or brings back the library you removed last month.</p> <p>This isn't a hunch. Oliver Zehentleitner ran 20 fresh agent sessions on the same codebase with the same request: simplify a retry wrapper. With no recorded reason, 7 of 10 suggested the change that had already been rejected. With one written-down reason in the repo, none did. (<a href="https://blog.technopathy.club/what-happens-when-a-coding-agent-forgets-why-a-change-was-rejected" rel="noopener noreferrer">his write-up</a>)</p> <p>CLAUDE.md and AGENTS.md help, but they're a file the model can choose to skip, and nobody keeps them current.</p> <h2> What I built </h2> <p>align-cli is a free, open-source CLI. It pulls the decisions out of where they already live (git history, ADRs, CLAUDE.md and AGENTS.md, PRs, and if you connect them, Jira, Linear, Notion, Slack and others) into a graph on your machine. Then, before your agent edits a file, it checks the change against those decisions. If the edit rewrites lines a decision wrote, it stops and asks you.</p> <p>Try it in a few seconds, nothing installed, no account, no API key:</p> <div class="highlight js-code-highlight"> <pre class="highlight plaintext"><code>npx @aligndottech/cli demo </code></pre> </div> <p>On your own repo:</p> <div class="highlight js-code-highlight"> <pre class="highlight plaintext"><code>npm install -g @aligndottech/cli align </code></pre> </div> <p>It plugs into Claude Code, Codex and Cursor, or runs as its own agent with your key or a local model. The graph is one SQLite file in <code>~/.align</code>. Imports are read-only.</p> <h2> Where it falls short today </h2> <ul> <li>Telling "this decision replaced that one" from "these two conflict" needs an AI key. Without one, related decisions just show up as related.</li> <li>The edit check is most battle-tested in Claude Code.</li> <li>It can't know a decision is out of date until someone makes the newer one. A lot of the devs I've talked to this week are fighting that same problem.</li> </ul> <p>It's MIT and on GitHub: <a href="https://github.com/aligndottech/align-cli" rel="noopener noreferrer">https://github.com/aligndottech/align-cli</a></p> <p>Try it and tell me what breaks. I read every issue.</p> ai claude opensource devtools