Improve Agents.md

[gordonwatts]

1. Init it properly
2. Make sure to add something about documentation so new user facing features have additions to the documentation.