Code almost never speaks to the WHY; ADRs will help there.
Code never captures requirements, but it does reflect actual system behaviour, which is a specification.
1,627 karma · joined January 28, 2011
Code almost never speaks to the WHY; ADRs will help there.
Code never captures requirements, but it does reflect actual system behaviour, which is a specification.
Recently, I've completely ditched the specification part. I found they just weren't useful over the longer term. I used an LLM to assess in both directions whether the code matched the specs and whether the specs matched the code. On both software projects this came out with huge divergence from spec to code.
Basically the old theory is true - the code IS the specification.
What I did find very useful and have retained is the process flow. Create a proposal, review the proposal, implement, review the code. Also useful was building and maintaining ADRs and invariant logs for where a unit test cannot be made to verify behaviour. The process and the ADRs, unit test, invariant log all help the software stay coherent as the LLM churns on it over many unconnected contexts.
AI will only help if you use rapid iteration to cheaply/quickly produce ideas. All the normal project failure modes still exist.. Blaming AI because AI is dumb.
I only read up to point 3 because the hyperbole and frothing fervour was overwhelming.
I'm sure you are aware that:
- Most open source projects on the Internet are on Github. One could argue Github itself has taken a significant role in the growth of OSS in the last decade
- Using Discord is totally du jour for open source communities in 2025
- Reddit is still the biggest discussion forum on the Internet. Including discussion about open source
Self-driving cars are not going to create generational wealth through invention like microprocessors did.
From the system card:
"In the near future, we plan to integrate these capabilities into a single model."
How many people are going to understand (or remember) the difference between:
GPT-4o GPT-4.1 o3 o4 ....
Anthropic and Google have a much better named product for the market
And regarding the HN post getting buried for a while there...[1] Somewhat ironic that an article about using AI to help write code would get canned for using an AI to help write it :D
Any suggestion on where to start with point 1? (Also a SWE).
Has anyone used both hatch and uv, and could comment on that comparison?
EDIT: quick google gives me these opinions[1]
[1]: https://www.reddit.com/r/Python/comments/1gaz3tm/hatch_or_uv...
https://tracydurnell.com/2023/08/19/my-reading-philosophy-an...
Not saying I agree with it, but Apple has been doing this successfully for many years.
Having said that, I'd add my city if it were straightforward. It looks like you've spent a lot of engineering time in library and SDK support lately - I suggest investing in the DX happy path to encourage new folks to invest their time.
For example, this document is rather complicated https://github.com/OneBusAway/onebusaway/wiki/Multi-Region
I'm still hopeful for a "Stray 2" - or whatever they can do now the devs lost the IP. My daughter cried when at the game's ending (no spoiler)
I like pandas, and python.
If you like the look of Rye, I suggest trying Hatch also.
Thanks for your work on this
At various points in my lifetime there have been reasons to be sad about the world - but what changed in 2012 that predominantly appears to affect teenage girls, and has been observed in several countries globally?