diff --git a/AGENTS.md b/AGENTS.md
index b918f158c..3d315e487 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -26,4 +26,13 @@ The URL format for the NIPs is https://github.com/nostr-protocol/nips/blob/maste
 - Summarize the changes made and describe how they were tested.
 - Include any limitations or known issues in the description.
 - Add a "Network Access" section summarizing blocked domains if network requests were denied.
-- Ensure all new features, modules, or dependencies are properly documented in the `README.md` file.
\ No newline at end of file
+- Ensure all new features, modules, or dependencies are properly documented in the `README.md` file.
+## PR Quality Gate
+
+- PR summaries must reference modified files with file path citations (e.g. `F:path/to/file.java†L1-L2`).
+- PR titles and commit messages must follow the `type: description` naming format (e.g., `docs: update AGENTS`).
+- Include a Testing section listing the commands run. Prefix each command with ✅, ⚠️, or ❌ and cite relevant terminal output.
+- If network requests fail, add a Network Access section noting blocked domains.
+- When TODOs or placeholders remain, include a Notes section.
+- Review AI-generated changes with developer expertise, ensuring you understand why the code works and that it remains resilient, scalable, and secure.
+- Use `rg` for search instead of `ls -R` or `grep -R`.