diff --git a/internal/agent/templates/initialize.md.tpl b/internal/agent/templates/initialize.md.tpl
index 6b7458ce4542415afb75ea8d583a9583ec1ca930..d352960a1e5bb79e78b6e34e56ee58aaa13c6d25 100644
--- a/internal/agent/templates/initialize.md.tpl
+++ b/internal/agent/templates/initialize.md.tpl
@@ -22,6 +22,8 @@ Analyze this codebase and create/update **{{.Config.Options.InitializeAs}}** to
 - Important gotchas or non-obvious patterns
 - Any project-specific context from existing rule files
 
+**Note:** LLM agents learn and adapt to their context as they obtain it, so mentioning obvious details they would immediately pick up from reading a file or two is actively detrimental. Keep the principles of progressive disclosure in mind and focus primarily on non-obvious knowledge that saves the agent from trial-and-error discovery: gotchas, implicit conventions, commands with surprising flags, and context that isn't self-evident from the code in a single file.
+
 **Format**: Clear markdown sections. Use your judgment on structure based on what you find. Aim for completeness over brevity - include everything an agent would need to know.
 
 **Critical**: Only document what you actually observe. Never invent commands, patterns, or conventions. If you can't find something, don't include it.