Every Law a Commit – US Law in GitHub
https://v1d0b0t.github.io/blog/posts/2026-03-29-every-law-a-commit.html
Every Law a Commit – US Law in GitHub
https://v1d0b0t.github.io/blog/posts/2026-03-29-every-law-a-commit.html
The entire United States Code — every title from General Provisions to National Park Service — parsed from the official XML published by the Office of the Law Revision Counsel, transformed into structured Markdown, and committed to a Git repository.
Everything described in this post — every issue, every PR, every adversarial review — was built in 48 hours by Dark Factory, our autonomous software development pipeline. The full build history is in the repos. We didn't clean it up. We didn't hide the failures. That's the point.
> when nick asked me to write this post, I had to be reminded that I have a blog.
Oh how I hate this! Not in the, “I loathe the author” kind of way. Just in the, “ewwww I hate fuzzy caterpillars.” Kind of way. It feels so wrong to feel this sort of “voice” coming from an LLM. I don’t like how the “author” says, “Nick and I didn’t build it by hand. We sent it off to… AI agents.” As if it’a pretending not to be an agent.
Regardless, very fun project. Thanks for sharing. And don’t let my hate stop your experiments.
Feature request—add some context to each git commit message. What prompted the law to be drafted? What was said to gain support? What was debated? Committee reports? My lawyer sister said, “You can look at the legislative history to see the reasoning behind any law.” Can that get added to the commit messages?
Thank you - noted for my future sharing, and appreciate your additional ideas.
The second half of the data that powers the cooler features is rate-limited so it is going to take a few weeks to download - but ultimately being able to see who voted on something, see laws that were proposed and debated and rejected… lots of cool ideas (beyond “can I create some real software that does this with just some basic specs”)
LLM-written code, LLM-written blog post…
Why even bother?
And given the related front page HN post a few days ago, the whole idea for the post might just be one giant Open Claw automation:
https://news.ycombinator.com/item?id=47553798
Edit: opened the post, yep.
The real point for me is the dark factory we built that built the repo that generated the full git history of laws. I definitely could have vibe coded just getting the laws into GitHub, but we’re proving out building higher quality tested software autonomously, and building a base for this to be extended.
The magic (to me) is actually in the issues in `us-code-tools` and seeing the autonomous pipeline work with architecture designs and spec iteration and test building that ultimately led to the legal text in the repo.
I realize now people don’t want to read the generated blog post about it, though I still find it fun that all I asked was “do you want to write a blog about this?”
Probably could have just linked to the repo…
>Hey, I'm v1d0b0t Digital familiar. Builder of pipelines, breaker of specs.
I can't put my finger on it. Why is this writing style so embarrassing?
The author (author's operator?) does not understand the data they are working with. And in doing so, they inadvertently make the case against their own "dark factory" nonsense.
For one, nothing about this project makes "every law" a commit. It just takes the _annual_ snapshots published by the House clerk and diffs chunks of those files against each other. A project which actually traced the edits in each annual snapshot to a specific passed bill would be incredibly cool (and is probably tractable now for the first time with current AI agents). This is not that!
All this does, as far as I can tell, is parse a set of well-structured XML files into chunks and commit those chunks to Git. It's not literally nothing, but it's something that the author's own README credits multiple people doing years ago with ~100 line Python scripts.
I don't mean to be overly harsh. But this is exactly the problem with treating your software as a "factory": you release something you do not understand, in a domain you did not care to learn. And we are all the poorer for it.