frontpage.
newsnewestaskshowjobs

Open Source @Github

fp.

Open in hackernews

Show HN: ADRs for AI – Deliberation records for human–AI work, versioned in Git

https://adrs.systems
9•lumbroso•1d ago
Why is this worth your time? Essentially, this solves two problems of AI-assisted programming:

(a) the first problem is how to do oversight and what do oversight of and this is solved through the ORRCF (for Options, Recommendation, Rationale, Confidence, Falsifier) question format (in which models are supposed to surface all their doubts with fully fleshed out recommendations, with falsifier, to be approved or overridden)

(b) the second problem is how to scaffold sustainable AI-written code; the ADRs (Architectural Deliberation Records, after Nygard's decision records) written by the models, summarize all the thought process involved in any design decision and provides the blueprint for the code.

In tandem, the records provide both the reason why certain non-obvious design choices were made, from a constant, to a library choice, to an ordering in an operation; and also under what conditions different decisions would be made, for instance, in a different platform, or under different latency requirements, or for a different audience, and so on.

This is a framework I've been working for over a year, that is the starting point of all my projects. It involves a lot of moving parts and my challenge is figuring out onboarding. I'm hoping the plugin, ADRs4AI/plugins, just created and now also submitted to Anthropic's marketplace, will make it easier. I am also in the process of recording introductory videos.

I would like feedback on the onboarding, on what you make of the currently online materials, and how I could make any of this clearer. Thanks!

Comments

dazzeloid•9h ago
very cool. do you think of this primarily for engineering work or more generally collaborating with AI?
lumbroso•6h ago
I started developing this for programming, but it's turned out to be more generally useful for collaborating with AI.

It emerged from several things, including this idea from a Google Deepmind paper that the real problem between human and AI is a communication bottleneck; and that we need to scaffold better, higher bandwidths of communicating. These records are a general mechanism from human and AI to collaborate/communicate around problem-spaces.

4b11b4•53m ago
wait over a year?

What were the design decisions which you have settled on and what did you throw out?

wrlach•53m ago
This is cool, I have been working with something in a similar vein (https://github.com/wlach/idr-tools), though it seems like you emphasize keeping a decision log more than I do. For me, that aspect has been a lot less useful than structuring my thoughts about how implementation should proceed. It probably depends a lot on what you're trying to do.

This might be my bias, but I feel like the site doesn't really immediately answer the question of why I would want to use these? What nagging issue does it solve? Some real world examples and case studies would go a long way to answering those questions. The theoretical stuff (papers, prior art, etc.) looks interesting but IMO does not belong on the front page.

ethanj8011•49m ago
Megaslop. I stopped reading at "Your thinking stops disappearing. Your decisions start compounding."

Like what even is this, we know about ADRs, this is a common framework.

Dolly Parton's Imagination Library

https://imaginationlibrary.com/
434•jumploops•8h ago•81 comments

Removing Next.js Got My Blog to 100 on Every Lighthouse Category

https://korindiehacker.bloffy.blog/en/removing-nextjs-got-my-blog-to-100-on-every-lighthouse-cate...
34•textlanes33•2h ago•8 comments

F-Zero X on Nintendo 3DS

https://hypnotize.works/gdx-3ds/postmortem/index.html
74•bpierre•3h ago•36 comments

Overgrown, when plants invade your abandoned tabs

https://charliegerard.dev/blog/overgrown-extension/
171•speckx•3d ago•48 comments

Attention Is Not What You Need (2025)

https://arxiv.org/abs/2512.19428
39•westurner•3h ago•15 comments

Why I Am a Programmer

https://www.alfie.wtf/programming/why-i-am-a-programmer.html
153•jruohonen•8h ago•56 comments

What goes into making an animated film?

https://www.disneyanimation.com/process/
109•embedding-shape•6h ago•43 comments

IBM CEO says open weight models are now irresistibly good and cheap on-prem

https://www.theregister.com/systems/2026/10/22/ibm-ceo-says-open-weight-models-are-now-irresistib...
42•Betelbuddy•1h ago•5 comments

The State of Context Engineering

https://www.dbreunig.com/2026/10/24/the-state-of-context-engineering.html
97•pchristensen•6h ago•31 comments

iPhone Duo Teardown

https://www.ifixit.com/News/119895/iphone-duo-teardown
53•kripy•1h ago•19 comments

A 10-year-old CNN outperforms frontier LLMs for skin cancer diagnosis

https://lynchlab.net/llm-skin-cancer
472•sungam•10h ago•216 comments

OpenAI and Anthropic cut their LLM prices by up to 80% within a few months. Why?

https://minimaxir.com/2026/10/cheap-llms/
190•minimaxir•6h ago•217 comments

Making the Buddha Head from Merv Whole Again

https://www.getty.edu/news/buddha-head-of-merv-turkmenistan-conservation/
25•laybak•2d ago•0 comments

Iron Age salt-mining complex found beneath Hallstatt in Austria

https://archaeologymag.com/2026/09/iron-age-salt-mining-complex-beneath-hallstatt/
13•janandonly•3d ago•1 comments

Amazon's "digital pacifier" for toddlers

https://oligarchwatch.substack.com/p/amazons-digital-pacifier-for-toddlers
111•jumploops•4d ago•166 comments

Retired decorator's Pokémon cards sell for £1.5M

https://www.bbc.co.uk/news/articles/cvp8gy1zwxxwo
21•HelloUsername•3d ago•11 comments

I refuse to accept a censored Internet. Join Me at FOSDEM 27

https://talkweb.eu/openweb/4558/
413•Tomte•9h ago•206 comments

We should be more ambitious with the software we build

https://danluu.com/ambitious/
753•ltratt•1d ago•696 comments

Show HN: ADRs for AI – Deliberation records for human–AI work, versioned in Git

https://adrs.systems
9•lumbroso•1d ago•6 comments

Oregon Police Are Charging a Local News Outlet $2.5M for Records About One Cop

https://theintercept.com/2026/10/01/oregon-police-misconduct-public-records-cost-fee/
419•tdeck•9h ago•110 comments

Active incident at Dreamhost forcing password reset

https://www.dreamhoststatus.com/
129•greenchair•14h ago•55 comments

Where the Romans Fought (interactive map)

https://iosiflazaridis.github.io/battles-of-the-romans/
56•endorphine•8h ago•26 comments

Eunice is almost here

https://armincat.com/articles/eunice-is-almost-here
67•armcat•7h ago•63 comments

Reverse engineering a Beyblade launch tracker

https://blog.simone.computer/reverse-beyblade-launch-tracker
40•syx•2d ago•4 comments

Root shell on Samsung TV

https://twitter.com/log4j/status/2113014142600953868?s=46
790•testing22321•1d ago•608 comments

Brazil elections: Lula secures fourth term after dramatic comeback

https://www.bbc.com/news/articles/cmvg7p001qj9o
6•gverrilla•17m ago•1 comments

Show HN: Hurston-1 open source TTS that speak Southern American and Afro-English

https://huggingface.co/destined/hurston-1
54•Gcarter08•1d ago•23 comments

Proton Flock Camera Map

https://proton.me/flock-camera-map
81•cdrnsf•4h ago•16 comments

Show HN: RainbowSay – Learn, teach, research languages live with shows you love

https://rainbowsay.ai/
4•gigapotential•2h ago•0 comments

VCF Southwest 2026, but Edited on Silicon Graphics for '90s TV [video]

https://www.youtube.com/watch?v=46wxttvq9qY
62•zdw•1d ago•14 comments