Add AGENTS.md documentation for developers and AI agents (#606)

This file helps onboard new contributors and AI agents working on the codebase.

Co-authored-by: Claude <[email protected]>

Author: macbre