Prerequisites
- Finished experiments with Insights enabled (run Run insights on older experiments if needed).
- Access to edit your product, tool, custom agent, or task setup.
Steps
1
Open the friction list
Open Analyze → All frictions for project-wide issues, an experiment’s Frictions tab, or the Brief on Comparisons.
2
Filter by where to fix
Filter Family to Machine or Task quality (or Where to fix to Setup) and clear environment or rubric problems first so results stay reliable. Then filter Where to fix to Product, Custom agent, Setup, or Agent behavior (sorted by Unrecovered runs by default).
3
Read the top friction and trace evidence
Open the friction to inspect What goes wrong, Why it matters, and Suggested fix. Under Recent evidence, select a cited step link to open Traces right at the failure point.
4
Copy as Markdown
Select Copy as Markdown to copy the problem summary, suggested fix, concentration, three recent trace links, and
frc_ ID into an issue or your AI assistant.5
Apply the fix in the right layer
6
Launch again and verify
Select Launch again on the experiment (or After a fix, run the N tasks that differed again inside a Clear difference Brief). Because frictions keep stable
frc_ IDs across experiments, check the new experiment’s Frictions tab to verify that affected runs decreased.Interpret the results
From the CLI and the plugin
Example prompt for your AI assistant:
Other ways to run it
- Track one tool: open any tool under Manage → Tools and inspect its Frictions tab across all experiments.
- Investigate with Ask Oqo: ask Ask Oqo to cross-check a friction against a public GitHub repository.
- Prevent regressions: put the experiment on a schedule after fixing.
Next steps
Frictions
Understand Where to fix, Family, and concentration rules.
Run details
Inspect timelines, transcripts, and changed files.
Track results over time
Keep fixed frictions from returning.
Install the Oqoqo Plugin
Fix frictions directly from your AI assistant.

