Hacker News new | ask | show | jobs
Show HN: add-reasoning-to-prs: a hook that adds unnoticed assumptions to PR desc (github.com)
1 points by bogatyrjov 10 days ago
I think when you want to truly understand how something works, you either reverse-engineer the thing, or you participate in its making, or at least, understand the reasoning behind the build.

Reading the documentation is not enough – you need to see how the thing was made, why certain decisions were made, what trade-offs were accepted, and what assumptions were made.

I don't really think it is possible to sustainably scale automated agentic end-to-end development without reviewing the code, or reading every line of agent reasoning.

So I wrote a claude code hook that takes your session transcript and before creating a PR, extracts decisionsl, assumptions and trade-offs that were made during the session (and possibly missed by the human) and appends them to end of PR description. In my testing with another repo, it produced real insights that raised real risks, that would be otherwise lost.

For now, it's only claude code, but I will add support for all other harnesses.

I would appreciate if you try it out and it's open to contributions.

1 comments

Interesting idea. Have you found reviewers actually use the generated reasoning, or does it mostly help the original author organize their thoughts?
So far I have more feedback from PR authors about them using it, and I have been dogfooding it myself. I need help validating it in teams. It reliably surfaces some trade-offs that I would otherwise miss (that are not in the diff). The reviewer angle is the more interesting one, but I don't have clear validation yet. If you try it on a repo with real reviews, I'd be happy to hear from you