Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 28 additions & 0 deletions documents/patterns/rose-feedback.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
---
authors: [ivett_ordog]
---

# ROSE Feedback

## Problem
When giving feedback to the AI, focusing only on the desired action risks the AI not understanding the human's goals and finding solutions that feel like malicious compliance. Emphasizing the risks and the desired outcomes leads to better results.

## Pattern
Structure your feedback using ROSE:

1. **Risk** — Describe the long-term consequence or negative impact of the current approach
2. **Observation** — What you see in the code/work that causes this risk
3. **Solution** — The specific action you want the AI to take
4. **Expect** — What success looks like (the benefits or improvements you expect)

By providing this context, the AI understands *why* the change matters, not just *what* to do, and is more likely to apply the principle broadly rather than just fix the immediate symptom.

## Example

**Risk:** The current tests are brittle, hard to read and are likely to become a maintenance burden.

**Observation:** This is due to the repetitive mock setups that show up in each test as irrelevant details.

**Solution:** Replace the mocks with either the real classes (when it has no side effects such as IO operations or database access) or with stateful fakes that simulate the behaviour of the real object.

**Expect:** The tests should be shorter, easier to read, and void of irrelevant details that are currently due to mock setups.
1 change: 1 addition & 0 deletions documents/relationships.mmd
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ graph LR

%% Pattern → Anti-pattern/Obstacle relationships (solves)
patterns/active-partner -->|solves| anti-patterns/silent-misalignment
patterns/rose-feedback -->|solves| anti-patterns/silent-misalignment
patterns/active-partner -->|solves| anti-patterns/tell-me-a-lie
patterns/active-partner -->|solves| obstacles/compliance-bias
patterns/active-partner -->|solves| obstacles/obedient-contractor
Expand Down
Loading