#AMLD Agent-Mediated #LiterateDevelopment methodology first draft, ready to be tested.
I would love some feedback.
https://hg.sr.ht/~travisfw/amld-method
#agenticCoding
I just began an #AMLD repository.
It is a template for Agent-Mediated #LiterateDevelopment methodology.
In a nutshell:
Design documentation and project management should be *on trunk* (or main branch) and must be enough to regenerate everything that has been previously generated with an #AI […]
This is what I am learning now. How best to maintain project management docs, specifications, tickets, and so on, on trunk.
I started out putting it in a separate branch and committing generated code to its own branch, and merging. I thought my prompting and writing was just for me, or at least […]
So, what does #LiterateDevelopment look like, now?
Well, it bears repeating that the *literate* part (which Robert C Martin would still call "code") should be committed to trunk. It needs to describe implementation, maintenance, testing, deployment, and all the same dimensions of utility […]
… #LiterateDevelopment vs #VibeCoding. FIGHT!
Also, people have *always* vibe coded!
You don't have to be around long to find code that makes you wonder … until you realize the author just didn't care.
Vibe coding is the engine driving so many startups toward their exit. If the goal is to […]
Actually, I want to pit #LiterateDevelopment against #VibeCoding directly.
Clean code has *always* been literate. That means a dev with the skills to maintain the code base should be able to read the code. The *only* valid argument against documentation has been that the code is […]
Caveats!
Primarily:
Docs are code!
Tickets. Diagrams. The roadmap. All the project management stuff defines the software. With Claude (I have yet to branch out, but believe me, it's coming) I have begun committing project management documentation to trunk. (Rename master to trunk, you […]
Whether you agree with, hate, or are turbulently navigating the transition of many teams to agent-mediated coding (I am considering the post from @anildash where he talks about #codeless, IE #LiterateProgramming or #LiterateDevelopment), Robert C Martin's book, Clean Code should be the bible in […]