ai: test comments by imagining them all deleted
Assisted-by: Claude Opus 5.5 via Claude Code
diff --git a/ai/_AGENTS.md b/ai/_AGENTS.md
index 6ce8fefc..86e95b89 100644
--- a/ai/_AGENTS.md
+++ b/ai/_AGENTS.md
@@ -106,6 +106,11 @@ label an obviously named function, or narrate the change for a reviewer
rather than the next reader — that last one belongs in the commit
message.
+Then imagine every comment deleted. Whatever would stop making sense
+is a hint the code should change instead — a clearer name, an
+extracted function, a type that makes the invariant explicit. Make
+that change and drop the comment; keep only the ones code can't carry.
+
## Version control
Always use jj (Jujutsu) for version control. Never run bare `git`