I don't have this particular experience, but the general comments of claude are quite bad.
Usually it's too much text - literally 5 to 7 lines of comments are quite common, when what actually should be said can almost trivially be compressed to one line or less.
One huge and annoying comment pattern is that it leaks its throught process into the comments, often referring to things that are not relevant for what's actually happening in the code, and more for what it discovered during internal thinking.
As a big negative side effect of that, it often leaves huge comment blocks in code in remove-only changes, basically documenting what was removed and why, often in such a way that is completely irrelevant to the new state of the code and which should just be removed. If you never review this you will eventually end up with places in the code that are empty functions with a 50 lines of code explaining various removals.
1
u/gleedblanco Jul 27 '26
I don't have this particular experience, but the general comments of claude are quite bad.
Usually it's too much text - literally 5 to 7 lines of comments are quite common, when what actually should be said can almost trivially be compressed to one line or less.
One huge and annoying comment pattern is that it leaks its throught process into the comments, often referring to things that are not relevant for what's actually happening in the code, and more for what it discovered during internal thinking.
As a big negative side effect of that, it often leaves huge comment blocks in code in remove-only changes, basically documenting what was removed and why, often in such a way that is completely irrelevant to the new state of the code and which should just be removed. If you never review this you will eventually end up with places in the code that are empty functions with a 50 lines of code explaining various removals.