Thanks for the informed answer. I agree on most of your points, and my experience goes in the same direction as yours : most of the problems I thought would happen due to the dynamic nature of the language did not really happen.

I'll certainly take a look at YARD.