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 <noreply@anthropic.com>

Author: macbre