Bad at writing

I spend most of my time hashing out PRDs with Claude, not vibe coding. Once the PRD is set I let it work. About 80% of features ship without revision.

The biggest problem I run into is not what you think.

• it’s not coding mistakes
• it’s not failing tests
• it’s not quitting early

It’s bad at writing.

It clearly understands my intent in conversation. It says things back to me that I like. Then when I ask it to “write the instruction,” it produces something that completely loses that intent.

Like I read it back and see a million ways that’s going to make agents do something dumb.

This means one thing: the most useful place you can spend your time is making sure ANYTHING written to context is solid:

• captures both the what AND the why
• preserves your actual intent
• lives where the agent will see it at the right time
• avoids failure modes (YOU have to learn these)

If you’re a software engineer trying to stay ahead of the agent wave, that’s the skill: Learn the failure modes.