Generate AGENTS.md

Create a repo-specific AGENTS.md that gives AI agents the context they need to work effectively. Every section should reference real commands, real paths, and real conventions from the repository — not generic advice.

Why this matters

An AGENTS.md is the single highest-impact addition for agent readiness. It directly addresses features across multiple pillars:

• Agent Instructions: agent instruction file, README with build/run/test, contributing guide, environment variable documentation
• Feedback Loops: test run documentation — agents need exact commands
• Policy & Governance: guardrails the agent must follow

Without it, agents guess at build commands, miss project conventions, run the wrong test suite, and don't know what's dangerous. The best AGENTS.md files share the same core pattern: real commands, clear structure, explicit boundaries.