Improve Agent guidance.

Perform a thorough, deep and full exploration of this repository including running the CLI and tests, with the goal to improve guidance for AI agents, by improving existing markdown files for coding agents, and creating an AGENTS.md