first attempt to document core

What's you plan about this link and the similar (hopefully upcoming) ones? Keep every markdown file in ```/agent-xx/doc/``` or group everything in a ```/doc/```directory?