[roywiggins]

I think you would be better served by a shorter, human-driven README hitting the important points and then a separate AI summary doc that's marked as such. Your rough outline is what I'd probably prefer to read.