Refactor test documentation and improve consistency in comments

Add comprehensive documentation and guidelines for various roles

updated with new prompts and new workflow to generate a document