diff --git a/AGENTS.md b/AGENTS.md
index 2e27f380a..f18a00881 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -71,3 +71,15 @@ Event sources
 | `appsec/` | Application Security Monitoring |
 | `tags/` | Tag extraction and propagation |
 | `fips/` | FIPS mode cryptography support |
+
+## Gotchas
+
+### Be careful adding logs inside the logs pipeline
+
+The extension re-ingests its own stdout/stderr as logs, so a line logged while handling a log
+(in `logs/` — processor, agent, flusher) feeds back through the same pipeline. In a
+per-log-line hot path this self-amplifies into a flood of both CloudWatch and Datadog logs,
+worst at `DD_LOG_LEVEL=debug`.
+
+Avoid logging in this area unless necessary; prefer a temporary instrumented build, or surface
+signal via a metric instead.