You are talking about documenting the intent of a piece of software if I understand correctly. But isn't that what READMEs and comments are for?