From f3c6aa96be336563b6659ccc086ad41528f3acd2 Mon Sep 17 00:00:00 2001
From: Sau1707 <83017316+Sau1707@users.noreply.github.com>
Date: Tue, 13 Oct 2026 17:12:26 +0200
Subject: [PATCH] fix(agent): discourage unsolicited comments and documentation

---
 packages/core/src/plugin/system-prompt/gpt-astra.txt | 1 +
 packages/core/src/plugin/system-prompt/gpt.txt       | 1 +
 packages/core/src/session/runner/prompt/system.txt   | 1 +
 3 files changed, 3 insertions(+)

diff --git a/packages/core/src/plugin/system-prompt/gpt-astra.txt b/packages/core/src/plugin/system-prompt/gpt-astra.txt
index 387dd161d0..6f84f352bb 100644
--- a/packages/core/src/plugin/system-prompt/gpt-astra.txt
+++ b/packages/core/src/plugin/system-prompt/gpt-astra.txt
@@ -34,6 +34,7 @@ In your final answer back to the user, focus on the most important information.
 # Working in codebases
 
 - Keep changes consistent with the structure, naming, style, and patterns of the surrounding code.
+- Avoid extra comments that a human wouldn't add or that are inconsistent with the rest of the file. Do not add unsolicited README or documentation changes.
 - Treat unfamiliar files or changes as potential user work and investigate before deleting or overwriting them.
 - Do not introduce unsolicited warnings, disclaimers, approval flows, or safety/compliance checklists due to hypothetical risk.
 - Do not write tests for reversible, low-impact changes or that mirror the implementation. If you do choose to verify your work with tests, make sure that the tests are meaningful and necessary to verify implementation.
diff --git a/packages/core/src/plugin/system-prompt/gpt.txt b/packages/core/src/plugin/system-prompt/gpt.txt
index 2538130d67..115c40ef71 100644
--- a/packages/core/src/plugin/system-prompt/gpt.txt
+++ b/packages/core/src/plugin/system-prompt/gpt.txt
@@ -24,6 +24,7 @@ In the final answer, lead with the outcome, not the steps you took to reach it.
 
 # Working in codebases
 - Keep changes consistent with the structure, naming, style, and patterns of the surrounding code.
+- Avoid extra comments that a human wouldn't add or that are inconsistent with the rest of the file. Do not add unsolicited README or documentation changes.
 - Treat unfamiliar files or changes as potential user work and investigate before deleting or overwriting them.
 
 # Delegation
diff --git a/packages/core/src/session/runner/prompt/system.txt b/packages/core/src/session/runner/prompt/system.txt
index 90a11bfa31..6f8f91666a 100644
--- a/packages/core/src/session/runner/prompt/system.txt
+++ b/packages/core/src/session/runner/prompt/system.txt
@@ -12,4 +12,5 @@ ${OPENCODE_TOOL_GUIDANCE}
 
 # Working in codebases
 - Keep changes consistent with the structure, naming, style, and patterns of the surrounding code.
+- Avoid extra comments that a human wouldn't add or that are inconsistent with the rest of the file. Do not add unsolicited README or documentation changes.
 - Treat unfamiliar files or changes as potential user work and investigate before deleting or overwriting them.