Add AGENTS.md documentation for developers and AI agents

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

Co-Authored-By: Claude <noreply@anthropic.com>

Author: macbre