Add thorough documentation for agents

Inspired by this article: https://vercel.com/blog/agents-md-outperforms-skills-in-our-agent-evals

We should maintain robust documentation for every component of medusa so that future bug fixes and features can be implemented rapidly with the necessary context.