diff --git a/AGENTS.md b/AGENTS.md
index 9938865a9..4659d0761 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -300,6 +300,12 @@ When referencing Comfy-Org repos:
 
 Rules for agent-based coding tasks.
 
+### Chrome DevTools MCP
+
+When using `take_snapshot` to inspect dropdowns, listboxes, or other components with dynamic options:
+- Use `verbose: true` to see the full accessibility tree including list items
+- Non-verbose snapshots often omit nested options in comboboxes/listboxes
+
 ### Temporary Files
 
 - Put planning documents under `/temp/plans/`
diff --git a/src/AGENTS.md b/src/AGENTS.md
index 2778d1b25..276948254 100644
--- a/src/AGENTS.md
+++ b/src/AGENTS.md
@@ -17,6 +17,7 @@
 - Clear public interfaces
 - Restrict extension access
 - Clean up subscriptions
+- Only expose state/actions that are used externally; keep internal state private
 
 ## General Guidelines