‹ BackHN Continuity

Thread

How to Write with an LLM

769 points · 420 comments · joeriddles

  1. semiquaver · · focus · HN ↗
    This would sound insane to me from two years ago but I have recently started insisting on writing all my own commit messages and pull request descriptions. I do usually have an agent review them for factual accuracy, but not rephrase them.

    It slows things down a bit, but in the best possible way. It has helped immensely to improve the depth of my understanding of the agent-generated code. When agents are doing everything its way too easy to “skim” diffs and not really absorb them.

    I always prided myself on my technical writing, and commit messages and PRs were a great place to hone that skill. I found that I missed it and my work is better now I’ve reclaimed that part of my old job back.

    1. LeafItAlone · · focus · HN ↗
      A big win of LLMs in my book is the absolute reduction of commit messages with just “fixes” or “updates”. Commit messages have become more meaningful and useful, even if far from perfect.

      We have one dev who uses LLMs to write the code, but still commits by hand. Most of his messages are of the type above, and none of them are useful.

      1. this_user · · focus · HN ↗
        I'm not sure that Claude's "Realigned the shape of the load-bearing ownership gate to reduce the blast radius of the design contract; confirmed, not assumed" is more meaningful than "fix".
        1. skissane · · focus · HN ↗
          > I'm not sure that Claude's "Realigned the shape of the load-bearing ownership gate to reduce the blast radius of the design contract; confirmed, not assumed" is more meaningful than "fix".

          For PR/commit descriptions, I mainly use Claude Sonnet 4.5. It isn’t perfect, but it produces significantly less of this weird gibberish than 5.x models or even Opus 4.x do

          I also use an iterative process in which it writes the description, I read it, and then either manually edit it or ask it to make changes

          1. my-next-account · · focus · HN ↗
            I use Astra at Very High, and shit is still bad. It doesn't actually understand anything, so it often says things which are clearly not needed to be stated. Recently, I've learned that I have very high standards for these things. For example, "fixes" as a commit msg just is NOT acceptable and would never fly where I work.
            1. rrr_oh_man · · focus · HN ↗
              Very high does not improve the model, fyi.
              1. my-next-account · · focus · HN ↗
                Wat, what am I paying for then?
                1. rrr_oh_man · · focus · HN ↗
                  Arguably, your LLM provider might be paying you, in a sense
                  1. oblio · · focus · HN ↗
                    As OpenAI's IPO troubles seem to indicate, that's an OpenAI skill issue.
                    1. oblio · · focus · HN ↗
                      Touchy OpenAI employees? :-)))
Open on Hacker News to reply ↗

Unofficial Hacker News client; not affiliated with Y Combinator.