I started writing this when I was having Claude review non-vibe coded apps I was rewriting, or building to study. As I ran into more frustrations, I added new notes.
Then, when vercel released their best practices, I loved the format so much, both for people to read, and for claude to review with, that I turned my chicken scratch (and some additional docs) into a NestJS skill for Claude.
Feel free to file issues, submit PRs, etc. Hopefully this makes Claude a little less bad for you as well.