What you did today will repeat itself multiple times in the future. Ugly code acts like infection. Introduce tech-debt in the cleanest way possible.

"Good code does not need comments" is the second "billion dollar mistake" after invetion of `nil`. We used to put explanations in all possible places except the related code line.

It's easier to deal with 5 combined concepts that provide solution for 50 problems, than with 50 solutions for 50 problems.

Design code for the process of understanding. Humans can deal only with ~4 ideas simultaneously. Reduce amount of involved ideas to a minimum.

Why we should care about LLMs' convenience more than about ours? Add more READMEs and comments for humans, and you find your AGENTS.md containing only AI-specific adjustments.

It's totally insane that we used to it.