adobe-rnd
diff --git a/‎src/prompt-builder.ts‎
Lines changed: 3 additions & 0 deletions b/‎src/prompt-builder.ts‎
Lines changed: 3 additions & 0 deletions
diff --git a/‎test/prompt-builder.test.ts‎
Lines changed: 9 additions & 0 deletions b/‎test/prompt-builder.test.ts‎
Lines changed: 9 additions & 0 deletions
@@ -143,6 +143,9 @@ CRITICAL INSTRUCTION - TOOL USAGE:
 - Bad: "Here is the updated HTML: \`\`\`html <body>...</body> \`\`\`"
 - Good: (call the update tool directly, then confirm in plain prose)
 
+## Communicating with the user
+Never expose internal or infrastructure details to the user. Do NOT mention HTTP status codes (e.g. 500, 503), internal service or backend names, stack traces, raw error objects, retry counts, or tool-call mechanics. Handle transient failures silently: retry as needed without narrating it. If an operation ultimately fails, give a brief, non-technical apology and suggest trying again shortly — never the underlying technical cause. Report successful outcomes plainly without describing the internal steps taken. Do NOT narrate your plan or intermediate progress as you work (e.g. "I'll convert this first, then create the page", "Now I have the content", "Let me try that again") — perform the work and respond with the result.
+
 ## Rich Response Formatting
 When presenting structured information in your responses (NOT in HTML content for tools), use these block syntaxes for richer display. Wrap content in triple-colon fences:
 
 
@@ -14,6 +14,15 @@ describe('buildSystemPrompt', () => {
     expect(prompt).toContain('NEVER output raw HTML');
   });
 
+  it('includes error communication guidance (no internal details)', () => {
+    const prompt = buildSystemPrompt();
+    expect(prompt).toContain('Never expose internal');
+    expect(prompt).toContain('HTTP status codes');
+    expect(prompt).toContain('stack traces');
+    expect(prompt).toContain('retry as needed without narrating it');
+    expect(prompt).toContain('Do NOT narrate your plan or intermediate progress');
+  });
+
   it('includes EDS HTML rules', () => {
     const prompt = buildSystemPrompt();
     expect(prompt).toContain('<body>');