Earlier quoted context omitted.
I recently did some work on a codebase I last touched 4 years ago. I didn't remember every line but I still had a very good grasp of how and why it's put together. (edit: and no, I don't have some extra good memory)
Lucky you. I always go "huh, so I wrote this?". And this was in the pre-AI era.
Cognitive Debt: When Velocity Exceeds Comprehension
151–160 of 234 posts
Re: Cognitive Debt: When Velocity Exceeds Comprehension
#152I thought when you vibe it, you're supposed to keep doing that forever.
If you need an explanation, ask the clanker.
Re: Cognitive Debt: When Velocity Exceeds Comprehension
#153Genuine question: so what?
First of all, team members leave all the time, and you're stuck staring at code nobody instantly understands.
Second of all, LLM's are a godsend in help you understand how existing code works. Just give it the files and ask it to explain to you what the components do and how they interact. It'll give you a high-level summary and then you can interactively dig in, far faster than has ever been possible before.
Heck, I often don't remember anything about code I wrote six months ago. It might as well have been written by someone else. And that's not an original observation either -- I remember hearing the same thing from other developers decades ago, as justification for writing better code comments.
Modern codebases are often far too large for any one person or even an entire team to fully comprehend at once. The team has cycled through generations of team members, with nobody who can remember the original rationales for design decisions.
LLM's are helping comprehension more than ever. I don't understand why people aren't talking about this more.
Re: Cognitive Debt: When Velocity Exceeds Comprehension
#154Richard Gabriel wrote a famous essay Worse Is Better ( https://www.dreamsongs.com/WorseIsBetter.html ). The MIT approach vs the New Jersey approach does not necessarily apply to the discussion of the merits of coding agent, but the essay's philosophy seems relevant. AI coding sometimes sacrifices correctness or cleanness for simplicity, but it will win and win big as long as the produced code works per its users' sta…
I hope people can ask themselves why the goal is "winning" and "winning big", and not making a product that you are proud of. It shouldn't be about VC funding and making money, shouldn't we all be making software to make the world a little bit better? I realize we live in an unfortunate reality surrounded by capitalism, but giving in to that seems shortsighted and dismissive of actual problems.
Re: Cognitive Debt: When Velocity Exceeds Comprehension
#155Re: Cognitive Debt: When Velocity Exceeds Comprehension
#156Yes I am aware this means my job is gone.
Re: Cognitive Debt: When Velocity Exceeds Comprehension
#157Earlier quoted context omitted.
I think that recording dialog with the agent (prompt, the agent's plan, and agent's report after implementation) will become increasingly important in the future.
I have this at the bottom of my AGENTS.md: You will also add a markdown file to the changelog directory named with the current date and time `date -u +"%Y-%m-%dT%H-%M-%SZ"`, record the prompt, and a brief summary of what changes you made, this should be the same summary you gave the developer in the chat. From that I get the prompt and the summary for each change. It's not perfect but it at least adds some context ar…
Re: Cognitive Debt: When Velocity Exceeds Comprehension
#158If the AI can just refactor the whole app whenever it wants w/o taking a person-month of effort, and you have rock-solid tests for everything, maybe human code comprehension isn't necessary? Yes I am aware this means my job is gone.
Re: Cognitive Debt: When Velocity Exceeds Comprehension
#159> Six months later, an architectural change required modifying those features. No one on the team could explain why certain components existed or how they interacted. I thought when you vibe it, you're supposed to keep doing that forever. If you need an explanation, ask the clanker.
This all sounds like the classic path I've seen low quality coders take, coding themselves into a corner until changes effectively become impossible.
For real people, that's when the coder finds a new job, often a promotion off the back of their dreadful architectural decisions, or if it's an agency, abandons the client.
I wonder if it will follow the same failure states, has anyone caught it making multiple versions of the same function yet? With slightly different bugs in them?
Re: Cognitive Debt: When Velocity Exceeds Comprehension
#160Editing a one shot on the otherhand reminds me of trying to mod a Wordpress plugin.