I've often thought that code should tell a story about what the system is supposed to do and if the story is not clear, that will probably be reflected in a system that does not work well.