On: The new rules of context engineering for Claude 5 generation models

[nickm12]

I believe both that code should be self-documenting but also that comments and documentation are a critical part of the code. Comments and documentation explain the functional contract of the code and why implementation choices were made.

Even if you have tests for an edge case, a comment inline with the code that explains why this edge case exists and why it is handled the way it is adds value to the code.

[adithyassekhar → nickm12]

I agree. I’m talking more about these agents going in and breaking things. They might get some context when a test fails.