Иногда пишу в комментариях TODO.
Но только для случаев, когда и так нормально работает.
Если вдруг будет серьезная переделка, в этом месте, то сделать нужно так и так.
А то ведь часто - начнешь делать задачу, а деталей всех не знаешь.
Только к концу знаешь всё, что надо, а зная всё сделал бы по другому.
Иногда пробегая свой старый код, видишь не вполне удачные решения (только "гении" всегда одинаково хреново пишут).
Ну и ставишь метку, мол перепилить потом, т.к. нет времени. Это нормально. Только не помню уже когда возвращался к своим меткам.
Печально, но мои ToDo частенько остаются в коде навека :)
TODO
Чтобы обнаруживать ошибки, программист должен иметь ум, которому доставляет удовольствие находить изъяны там, где, казалось, царят красота и совершенство. Фредерик Брукс-младший