Agents are human. PRD or die!
Agents are human. PRD or die! Ok, maybe not human, but human like. Enough to create chaos and wreak havoc. Enough to take you to the edge of insanity, if you're not careful. If you don't write a solid Product Requirements Document. Note: These are my observation after having worked with Windsurf, Cursor, and now Claude Code in both the app and in VS Code, building a web app with a Firestore set-up and some complex business logic. I'm not an AI expert, I'm not a developer, but I have about 20 years of experience working in fintech. Mainly as a product manager, managing teams of developers and business analysts, working with architects and other stakeholders. What do I mean by human like? In my experience, at this point in time, AI agents are as good or better than the best developers. For good or for worse. So, let me elaborate. On this potential issue, on confusion, my sins, and that special place in hell. As a product manager, I've worked with overloaded backlogs of items I wanted to build. I've had a million requests from stakeholders, many half baked. I've come in fresh to teams who had gone down one particular path, with a set in stone architecture, and, important, terminology and concepts that were in no way logical to the outsider. Like a company isn't a company. Say what!? Yes, once decided, something completely illogical become logical, or at least sets a standard. Even for supposedly standard terms, everyone makes assumptions based on their own experience and context. In all these cases, working with smart and dedicated people, I have experienced chaos and havoc, when we didn't take the time to define exactly what we wanted to build. That's why I say "agents are human.", or at least "agents are human-like." A) They are as good or better than good developers. B) Each time you run a session with an agent, it's like working with a new developer on the team. Without context, they will make assumptions to do the job you ask them to.