Для Руби кода можно использовать специальные комментарии:
# TODO add named_scopes
# FIXME method A is broken
# OPTIMIZE improve the code
И просматривать их с помощью rake notes:
app/controllers/application_controller.rb:
* [ 6] [TODO] Продумать авторизацию
app/models/comment.rb:
* [ 8] [TODO] exclusion registered users nicks
app/models/message.rb:
* [ 8] [TODO] antispam
app/models/tag.rb:
* [27] [FIXME] игнорировать не уникальные slug
app/views/posts/show.html.slim:
* [14] [OPTIMIZE] переписать этот ужас
app/views/shared/_sidebar.html.slim:
* [25] [TODO] icon.png
При этом можно смотреть метки только одного типа:
rake notes:todo
rake notes:fixme
rake notes:optimize
Или даже свои собственные:
rake notes:custom ANNOTATION=MYANNO
И ещё один плюс меток в том, что они обычно подсвечиваются в текстовых редакторах.