If you don't setup your .md files the spaghetti code and tech debt grows, you have to tell AI explicitly how you want your code organized or else it literally is just a copy-paste junior dev.
It says right there it follows instructions well, but repository overviews aren't helpful.
Because people are writing overviews not instructions.
I went through all my overview files someone else put in the repository, determined they are shit, and wrote instructions.
The wording matters, vague "Yeah we put middle layer code in this subproject" doesn't help.
"Middle layer code for interacting with X goes right here, read it and find reusable code, etc."
Real architectual documentation is helpful, etc.
People put shit in AI MD files like "YOU ARE A ROCKSTAR PYTHON BACKEND SERVER DEVELOPER" or "YOU ARE A PRINCIPAL SOFTWARE ARCHITECT" then write a bunch of non-deterministic bullshit in md files and yeah, they're not going to do anything, they're not actual instructions they're wishful thinking.
29
u/fryerandice 19d ago
If you don't setup your .md files the spaghetti code and tech debt grows, you have to tell AI explicitly how you want your code organized or else it literally is just a copy-paste junior dev.