first attempt to document core

I think you can keep the link local (that is ```[system agent documentation](doc/systemagent)``` and it will work locally, within github and in readthedocs.org.