From 0cbeaf8ea87a30b8f556faefbcb65adfe81be5a4 Mon Sep 17 00:00:00 2001
From: alltheseas <64376233+alltheseas@users.noreply.github.com>
Date: Mon, 29 Dec 2025 14:41:56 -0600
Subject: [PATCH] Update AGENTS.md

- add nesting rules
- add nostrdb consideration
- change code commentary to docstring coverage requirement
---
 AGENTS.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/AGENTS.md b/AGENTS.md
index f77554aa..a9a7d1e8 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -40,5 +40,7 @@ Damus is an iOS client built around a local relay model ([damus-io/damus#3204](h
 3. Commits should be standalone.
 4. Code should be human readable.
 5. Code should be human reviewable.
-6. Use code comments to add context.
+6. Ensure docstring coverage for any code added, or modified.
 7. Review and follow `pull_request_template.md` when creating PRs for iOS Damus.
+8. Ensure nevernesting: favor early returns and guard clauses over deeply nested conditionals; simplify control flow by exiting early instead of wrapping logic in multiple layers of `if` statements.
+9. Before proposing changes, please **review and analyze if a change or upgrade to nostrdb** is beneficial to the change at hand.