I totally agree. Using Git as a diary should be strictly for local development with AI tools, just to track failed attempts and avoid loops. But that messy history shouldn't reach the mainline.
Upstream commits must be clean, squashed, and strictly human-readable—no debugging noise or dead ends. It's essentially two layers: a messy 'AI diary' for local exploration, and a curated history for future maintainers.
'Dirty workshop, clean mainline.' Thanks for highlighting this boundary; I'm making it a permanent rule in my workflow!
Hi again,
Not against of the clean git history, but as deadwood mention going back in the git history to know why something was that way, I saw one person having an adr documentation in sync with the git history, that was somehow generated/managed with AI.
I don’t know exactly how it was made, but was exactly the scenario mentioned, in a even more human friendly approach.
Again, there is lot of resources/tools that are emerging based on AI and I can’t track/test it all, but every single dimension of what used to be are been research to have an AI version of it and some novel experiments to give you more and more human friendly understanding of the code.
That said, it’s a ongoing thing, not all will be success and lots make more sense having some degree of local AI (no token$) to be pratical.
Logs and documentation’s got even another level up, it is a new kind of code, cause it also can be consumed from agents.
I myself got producing much more “documents” artifacts that I never used (or will use) myself, but anyway, commenting cause I saw that exact scenario and apparently an impressive result.
Regards,
Edited by CoolCat5000 on 15-05-2026 22:32,
9 days ago