You can add some special notes to your source code comments in Rails to remind you later of stuff you need to do:
class Article < ActiveRecord::Base
# TODO add named_scopes
# FIXME method A is broken
# OPTIMIZE improve the code
has_many :comments
....
end
You can list these special notes with a rake task:
$ rake notes
app/models/article.rb:
* [2] [TODO] add named_scopes
* [3] [FIXME] method A is broken
* [4] [OPTIMIZE] improve the code
You can also list notes of each kind individually with rake notes:todo, rake notes:fixme and rake notes:optimize.
You can even list your own, custom notes with rake notes:custom ANNOTATION=MYANNO.