The following improvements should be made:

• Keep .fail file around in the event of failure to pickle
• Remove comments when generating a .fail file
• Give instructions for manual retry on failure to extract to pickle
• Clarify language in “Ensure run from git repo”