Skip to main content
Reflections turn your agent’s own history and configuration into improvements. On a recurring schedule, the agent reviews recent tasks and its instructions, looks for repeated problems or conflicting rules, and writes up a small number of concrete fixes: a new skill, an edit to an existing one, an instruction change, a trigger change, or something only a human can do. Every suggestion cites its evidence, such as the tasks where a problem occurred or the instructions involved in a conflict. With Review Queue, nothing changes until you accept it. With Auto-Apply Suggestions, the default for new agents, suggestions apply automatically. After a change lands, the agent keeps watching to see whether the problem actually went away. Reflections live on the agent’s Performance page, in the Reflections section of the right-hand panel.

​
Why use Reflections

Without Reflections, an agent only improves when you notice something and fix it by hand. That works for the issues you happen to catch, in the tasks you happen to read. With Reflections on, the agent:
  • Looks across many tasks, so it finds problems that repeat rather than one-off mistakes
  • Cites its evidence: which tasks, how many times, when it last happened
  • Proposes a specific change, not a vague observation, and can apply it for you when you accept
  • Tracks the outcome and tells you if the same problem comes back after a fix

Without Reflections

You spot a bad answer, dig into the task, and edit a skill or instruction yourself. Repeat for every issue you happen to see.

With Reflections

The agent finds that the same lookup has failed 4 times across 2 tasks, proposes the fix with links to the evidence, and applies it when you click Accept.

​
How a review works

Reflections look for repeated problems in recent tasks and conflicts in the agent’s configuration. Each suggestion explains the issue and the proposed fix.
1

Review recent work and instructions

The agent reviews task history alongside its current instructions, skills, and triggers.
2

Propose a fix

Suggestions include supporting evidence and a recommended change or a step you need to take.
3

Apply or review

Choose whether to review suggestions yourself or let eligible suggestions apply automatically.
4

Track the result

After a change is applied, Reflections track whether the original problem recurs. A recurring problem is flagged as Didn’t hold.

​
What a reflection can propose

With Auto-Apply Suggestions selected, trigger changes can apply automatically. A changed schedule takes effect immediately.

​
Can Reflections find duplicated or conflicting instructions?

Reflections can detect duplicated and contradictory instructions across the agent’s system prompt, attached SKILL.md files, and enabled trigger prompts. When Reflections is enabled, configuration changes can prompt checks as well as recurring reviews. The evidence identifies the source instructions, so you can see which rules need attention.
  • Duplicates: Reflections can propose removing redundant instructions and leaving a reference to the source of truth.
  • Contradictions: A direct edit needs chat evidence showing which rule should win. Without that evidence, Reflections can delegate a chat to ask the owner instead of choosing a rule arbitrarily.
  • Different contexts: Specialized instructions, rules for different situations, and references to another source are not inherently duplicates or conflicts.

​
Turn Reflections on

New agents on the Pro plan and above start with Reflections on and Apply Suggestions set to Auto-Apply Suggestions. Existing agents keep the settings they already have. If Reflections is off for an agent, turn it on as shown below, and review Apply Suggestions first to choose whether changes wait for you or apply automatically.
1

Open the agent's Performance page

Click Performance in the agent sidebar, then find the Reflections section in the panel on the right.
2

Enable Reflections

Click Enable Reflections. This creates the recurring review automatically, so there is no schedule to set up.
Agent Performance page with the Reflections section and its settings icon in the right-hand panel
3

Open the settings

Use the settings icon on the Reflections header to choose how suggestions are applied and where reports go.
Reflection settings panel showing Enable Reflections, Apply Suggestions, and Report Delivery options

​
Apply suggestions

This decides what happens when the agent proposes a change. New agents default to Auto-Apply Suggestions. Switch to Review Queue if you want to approve each change first. The default doesn’t change the setting on existing agents.
Every suggestion waits for you. Nothing about the agent changes until you accept it.Best for: production and customer-facing agents, or any agent where you want to see each change first.
Auto-apply attempts every suggestion the owner could accept, including skill deletion, trigger edits, and delegated agent tasks. It is not limited to low-risk or high-confidence suggestions. You need permission to edit the agent to select it; a change that cannot be applied remains pending.Best for: agents where you want changes applied without reviewing each suggestion first.
Needs you and other acknowledge-only items stay for review. Auto-apply does not bypass execution approvals for actions performed by a delegated agent task.

​
Report delivery

Reflection reports stay in the app by default. Turn on a channel if you want to hear about them elsewhere.
All delivery is off by default. Enabling Reflections on its own never sends anything outside Gumloop.

​
When reviews run, and when they’re skipped

Reviews run on a recurring schedule once enabled. A scheduled review can be skipped when there is no new activity or too little recent activity to review. Skipped reviews cost nothing and stay quiet unless you turn on Notify When Skipped.

​
Reading the Reflections section

The Reflections section lists recent suggestions and summarizes their status. View all opens the full history, grouped by when each suggestion happened. Switch the view from All to Needs Review to show only suggestions waiting on you. Search matches words in suggestion names, explanations, and prompts across that agent’s history, ignoring case.
Reflections section listing recent suggestions with their statuses and a summary line of counts
Under the heading, a one-line summary counts the queue: something like 126 waiting · 141 holding · next review in 9 hours.

​
Statuses

​
Reviewing a suggestion

Click any row to open the full detail view.
Reflection detail view with tags, status, evidence, impact, recommended action, and Dismiss and Acknowledge buttons
A reflection detail contains:
Use the arrows at the bottom of the detail view to page through the queue without going back to the list.

​
Accepting, dismissing, acknowledging

When you manually accept a trigger change, a confirmation appears first (Change this agent’s trigger?) because the new schedule takes effect immediately. This manual confirmation does not mean trigger changes are excluded from Auto-Apply Suggestions.

​
After a change is applied

Applied suggestions keep reporting back. The detail view shows before/after numbers for the signal that motivated the change, how often it has recurred since, and whether the change is still in place. If the problem returns, the suggestion flips to Didn’t hold, and the agent can propose a different fix in a later review.

​
How Reflections differ from other self-improvement features

Reflections review work proactively and track whether the problem recurs after a change.

​
Best practices

Start in review queue

Use Review Queue when you need to approve each change before it applies.

Clear the queue regularly

Review pending suggestions while their evidence is still relevant. Accept useful changes and dismiss ones you do not want.

Act on Needs you items

These identify a step the agent cannot take for you, such as refreshing a connector or granting access.

Watch for Didn't hold

A change that regressed is a sign the real cause is elsewhere. Worth a look from a human.

Give it enough traffic

An agent with little recent activity may skip scheduled reviews.

Turn on reports

Enable email or Slack reports to review suggestions without checking the Performance page every day.

​
FAQ

A scheduled review can be skipped when there is no new activity or too little activity to review. Skipped reviews do not use credits.
A review consumes credits like any other agent work, and each reflection shows its Review credits in the detail view. Cost scales with how much activity there is to analyze.
Not directly. Task-history reviews run on their recurring schedule. Configuration edits can also prompt instruction-conflict checks. You can ask the agent in a task to look at recent work, but that uses regular agent abilities rather than a scheduled Reflections review.
Nothing breaks. They stay in the queue, and later reviews may supersede them with better versions. The counts in the Reflections summary keep growing, so it’s worth a periodic pass.
Yes. Auto-apply can remove skills, change triggers, or start delegated agent tasks without a separate review of each suggestion. Needs you items stay for review, and delegated tasks still follow execution approvals. Choose Review Queue if you want to approve every suggestion yourself.
Anyone with permission to edit the agent. Viewers can’t enable Reflections, change its settings, or accept and dismiss suggestions.
Yes. Skill and instruction suggestions show a preview of the exact change before you accept, and the detail view keeps the applied timestamp along with the tracking numbers for the signal it was meant to fix.