Document the rationale behind each directory and guidelines on how to decide where to put new code in a dedicated markdown file. Update AGENTS.md with a summary and a reference to the new markdown file.
