7 karma · joined February 8, 2026
One feature i would like to talk about: Branch Story (VS Code extension + npm). It captures the reasoning, diffs, and terminal output as work happens, then surfaces it at PR review time, so a reviewer knows why the code is the way it is instead of just reading a diff and hoping it's fine.
There's also "why is this line here": right-click any line in the editor, get the decision behind it.
Re: noise — I agree, that’s the main failure mode for any PR bot.
A few things I did to keep signal high:
Only trigger on explicit file patterns (no fuzzy matching by default)
Idempotent comments — it updates instead of spamming new ones
If multiple decisions match, it groups them into a single comment
Severity levels (info / warning / critical) so teams can tune strictness
Optional “fail critical” mode so it never blocks PRs unless configured
The goal is that it behaves more like a linter than a chatbot — predictable and quiet unless something clearly matches.
If it ever becomes background noise, it’s failed
This is still just markdown in the repo. The Action doesn’t replace ADRs, it just surfaces the relevant ones automatically in PRs so reviewers don’t have to remember to look for them.
In teams where people consistently check ADRs, this probably isn’t useful.
In teams where the ADR exists but nobody remembers it during review, this helps reduce that friction.
And yeah — the Mongo example was dramatized. The real version was just re-explaining a past decision in a design doc. Not catastrophic, just wasted cycles.
Appreciate the sanity check.