docs: add AGENTS.md

[Aliserag]

Summary

Adds AGENTS.md — the open standard (agents.md, Linux-Foundation-backed, adopted by 60K+ repos) that guides AI coding agents (Claude Code, Codex, Cursor, Copilot, Windsurf, Gemini CLI) on a per-repo basis.

How this file was generated

Authored via an evidence-based generator skill with a strict verify-before-claim protocol:

• Every build/test command traced to an actual target in Makefile / package.json / equivalent
• Every file path verified via Glob/Read
• Every version number pulled from go.mod / package.json / foundry.toml / etc.
• Every count (targets, scripts, directories) re-executed with the precise command before writing
• Every line-number citation re-read before writing
• Internal consistency sweep (no contradictions between sections)
• Iterated with self-scoring on Coverage / Evidence / Specificity / Conciseness until all four axes reached 10/10

What AGENTS.md contains

• Overview grounded in README + actual source
• Build and test commands (only ones that exist in the manifest)
• Architecture map (real directory layout, real contract/module names)
• Conventions & gotchas (non-obvious rules verified in source)
• Files not to modify (generated / vendored / lockfiles)

Test plan

• File renders on GitHub
• Every command verified against the relevant manifest
• Every path verified to exist
• No approximations or invented commands