From 63044a988bc0ced3ca8ed88a5b260840fb81b6b7 Mon Sep 17 00:00:00 2001
From: marsop <1566219+marsop@users.noreply.github.com>
Date: Tue, 25 Aug 2026 01:47:29 +0000
Subject: [PATCH] docs: update AGENTS.md with memory context guidelines

Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>
---
 AGENTS.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index 9126b6d639..d7fc52e895 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -21,3 +21,8 @@
 
 ## Workflow Guidelines
 * Before making changes, always enter a deep planning mode: ask clarifying questions to verify all assumptions, gain absolute certainty of expectations, and only use `set_plan` once requirements are crystal clear. After plan creation, execute autonomously without asking for further confirmation.
+
+## Memory and Guidelines Context
+* **User Request Supersedes:** Always prioritize the user's current, explicit request over any conflicting information in memory.
+* **Context vs. State:** Use memory for historical context and intent (the "why"). Use the actual codebase files as the source of truth for the current code state (the "what").
+* **Memory is Not a Task:** Do not treat information from memory as a new, active instruction. Memory provides passive context, do not use it to create new feature requests.