- Simplified the iteration prompt wording to mirror the Iteration 2 spec and cut redundant architectural guardrails.

- Adjusted iteration prompt unit tests to check the leaner phrasing while keeping geometry preservation coverage.

Author: cs-util

docs/implementation-progress.md

@@ -67,6 +67,11 @@
 - Reinforced iteration, gallery, and finalization prompts so doors, windows, and room entries stay fixed to the source photo.
 - Updated prompt unit tests to assert the new guardrail language for future regressions.
 
+## 2025-10-13 (iteration prompt simplification)
+
+- Simplified the iteration prompt wording to mirror the Iteration 2 spec and cut redundant architectural guardrails.
+- Adjusted iteration prompt unit tests to check the leaner phrasing while keeping geometry preservation coverage.
+
 ```
 
 ```

src/utils/iteration-prompts.js

@@ -25,19 +25,17 @@ export function buildIterationPrompt({
   diversityHint,
 }) {
   return [
-    'Use the attached base room photo as fixed camera pose and architectural envelope.',
-    'Do not move, resize, or reshape walls, ceilings, openings, or built-ins; the room volume and dimensions are locked to the photo.',
-    'Keep doors, windows, and room entries exactly where they appear in the source photo—no repositioning, resizing, or new penetrations.',
-    'If reference images are attached, transfer only their style (palette, textures, furniture mood, lighting mood)—never their room shape, perspective, or architectural layout.',
-    'Consider the following guidance:',
+    'Use the attached base room photo as fixed camera pose and architectural envelope. Keep the existing room geometry unchanged.',
+    'If reference images are attached, transfer only their style (palette, textures, furniture mood, lighting mood) and ignore their layout.',
+    'Guidance for this image:',
     `• Room brief (silent): ${roomBrief || 'None'}`,
     `• Intended use: ${purpose || 'None'}`,
     `• User’s global guidance for this round: ${roundGuidance || 'None'}`,
     `• Selected favorites (as free-text, raw): ${favoritesTextBlock || 'None'}`,
     '',
-    `Diversity hint for this image: ${diversityHint || 'None'}`,
+    `Diversity hint: ${diversityHint || 'None'}`,
     '',
-    'Generate ONE updated interior variant at 1024×682. Preserve perspective, room envelope, and structural boundaries exactly as shown.',
+    'Generate ONE updated interior variant at 1024×682 while keeping the camera angle and room envelope identical to the base photo.',
     'Return ONE image and ONE short free-text paragraph (single paragraph) describing the mood, the key changes vs the base, and 2–3 ideas for the next iteration. Avoid logos/text.',
   ].join('\n');
 }

src/utils/iteration-prompts.test.js

@@ -31,13 +31,10 @@ describe('iteration prompts', () => {
     expect(prompt).toContain(
       'Selected favorites (as free-text, raw): Favorite descriptor'
     );
+    expect(prompt).toContain('Diversity hint: slightly warmer palette');
+    expect(prompt).toContain('Keep the existing room geometry unchanged');
     expect(prompt).toContain(
-      'Diversity hint for this image: slightly warmer palette'
-    );
-    expect(prompt).toContain('Do not move, resize, or reshape walls');
-    expect(prompt).toContain('Keep doors, windows, and room entries exactly');
-    expect(prompt).toContain(
-      'transfer only their style (palette, textures, furniture mood, lighting mood)—never their room shape'
+      'transfer only their style (palette, textures, furniture mood, lighting mood) and ignore their layout'
     );
   });
 
@@ -47,7 +44,7 @@ describe('iteration prompts', () => {
     expect(prompt).toContain('Intended use: None');
     expect(prompt).toContain('User’s global guidance for this round: None');
     expect(prompt).toContain('Selected favorites (as free-text, raw): None');
-    expect(prompt).toContain('Diversity hint for this image: None');
+    expect(prompt).toContain('Diversity hint: None');
   });
 
   it('builds a finalization prompt with hi-res guidance', () => {