Live data from Hacker News

Cognitive Debt: When Velocity Exceeds Comprehension

rockoder.com

151–160 of 234 posts

Re: Cognitive Debt: When Velocity Exceeds Comprehension

#151
post #56
post #35

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.

It feels like that at first, especially as I get older. But I still think it comes back to me a lot quicker if I once understood it than if I was learning it from scratch. Possibly just because I know how I think.

Re: Cognitive Debt: When Velocity Exceeds Comprehension

#152
> 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.

Re: Cognitive Debt: When Velocity Exceeds Comprehension

#153
> 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. The engineer who built them stared at her own code like a stranger’s.

Genuine 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

#154
post #125

Richard 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.

Some of my projects are built with the goal of making really good software. Some of my projects are built with the goal of making money. I take pride in doing things well, but I don't let my pride get between me and financial freedom.

Re: Cognitive Debt: When Velocity Exceeds Comprehension

#157
post #97

Earlier 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…

How often, in your experience, do people read those auto-generated markdown files? Do you have any empirical data on how useful people find reading other people's agents' auto-generated files?

Re: Cognitive Debt: When Velocity Exceeds Comprehension

#158

If 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.

Yup. This is exactly what is going to happen. It’s strange that so many people here can’t seem to extrapolate from the current state of things. It’s inevitable.

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.

And when the clanker can't understand its own code?

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

#160
The trick I've found is to vibe libraries that do one thing well with clear interfaces. The experience becomes more like importing a package which arguable has the same cognitive debt issues described above.

Editing a one shot on the otherhand reminds me of trying to mod a Wordpress plugin.

Post reply on HN