From f45e2fd89a5462f5d1795b91464d82833726629a Mon Sep 17 00:00:00 2001 From: Eric T Date: Tue, 19 Aug 2025 20:53:56 +0100 Subject: [PATCH 1/3] docs: document PR quality gate rules --- AGENTS.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/AGENTS.md b/AGENTS.md index b918f158c..c28bdc74b 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -26,4 +26,11 @@ 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`). +- 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. +- Use `rg` for search instead of `ls -R` or `grep -R`. From eeebe3900c89f48509968405ca934b9fa7c55258 Mon Sep 17 00:00:00 2001 From: Eric T Date: Tue, 19 Aug 2025 21:09:50 +0100 Subject: [PATCH 2/3] docs: document naming format requirements --- AGENTS.md | 1 + 1 file changed, 1 insertion(+) diff --git a/AGENTS.md b/AGENTS.md index c28bdc74b..e4a61786d 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -30,6 +30,7 @@ The URL format for the NIPs is https://github.com/nostr-protocol/nips/blob/maste ## 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. From 2490c3241abb72011bf406041506a1dd107295ff Mon Sep 17 00:00:00 2001 From: Eric T Date: Tue, 19 Aug 2025 21:23:25 +0100 Subject: [PATCH 3/3] docs: emphasize human expertise for AI --- AGENTS.md | 1 + 1 file changed, 1 insertion(+) diff --git a/AGENTS.md b/AGENTS.md index e4a61786d..3d315e487 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -34,4 +34,5 @@ The URL format for the NIPs is https://github.com/nostr-protocol/nips/blob/maste - 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`.