upvote
I was just trying to help a vibe coder and immediately noticed that their README.md was over 2,000 lines long. I asked, "Why is your readme so long?" and their response was, "This is just a really complicated application."

The app essentially manages a bunch of TODO items written in markdown.

reply
For some reason AI coding agents seem to think a README should be a Product Requirements Document (PRD).

I think it's because most projects don't have any settled place (or at least, any place that lives inside the project's source-code repo) to record PRD-like information.

But because AI coding agents really do benefit from having PRD-like info (i.e. a hierarchical breakdown of the "intended what" and "intended how" of the system that "should" exist in the repo, kept updated to reflect changing ideas about those intentions), they really want to record that type of info somewhere, so they can then reference it.

AI coding agents don't seem to have any "taste" (or maybe "confidence"?) when it comes to asserting that even if you don't already have a separate PRD-like file in the repo, you should have one, if you want the agent to do its job well, and so it would request you to let it create one (or just automatically do it.) Instead, they just shrug and cram the PRD stuff into whatever structure you do already have. Which, if you're starting fresh with a greenfield project, is usually just a README.

(I hypothesize that if you tell an AI coding agent to use Behavior-Driven Development [BDD] on a greenfield project, it'll probably lean toward maintaining its PRD-like info in the form of BDD test cases. Haven't tried this experiment yet; would be interested to know the outcome!)

reply
That is exactly what happened in this case; the readme was the PRD.

Throughout the document Claude kept claiming that issues were "mitigated but not fixed". They were essentially bandaid fixes for things it couldn't figure out. When I pointed this out to the author he said, "Well Claude thinks it works."

I wonder what happens to software when enough people try to ship projects like this.

reply
Yup that makes sense. Thanks for the feedback, we'll make some changes shortly!
reply
> Talk without talking. > Input text at the speed of speech, silently and invisibly.

I understood from just this. But the demo video impressed even further.

> Spent 30 seconds scrolling down to try to figure out what this is.

Did you try reading the site? Or maybe doing something other than just scrolling?

Does it need some form of subway surfer to get you to pay attention?

> Eventually clicked away from the site because it was taking too long to get to the point.

So yeah... subway surfer. This generation is cooked.

reply