I did not play around with your code but I find the idea intriguing and I hope you pursue it. Guided stuff like this, where the human-only component (like documentation) is programmatically conducted, rules. Anything to help devs do more documentation with less hassle is a good idea.