Why this matters
- 🧠 Free up senior developers from repetitive diagnosis
- 🧵 Keep conversations in the issue — no disruptive PRs or branches
- 🛠️ Get actionable suggestions fast, without sacrificing code ownership
- 🔍 Surface missing context early, avoiding wasted time or misunderstandings
Create a New Use Case
1
Open the Use Cases page
From the sidebar, click
Use Cases
, then select Create Use Case
.2
Name your Use Case
Use a clear name like
Bug Triage with Suggestions
.Set up the Trigger
1
Edit the trigger block
Click on the default trigger block in the canvas to configure it.
2
Select Issue Opened as the trigger type
Select
Issue Opened
to trigger the workflow on every new issue.3
Configure delay
Set a delay of 1-2 minutes to allow the user to complete the initial setup of the issue.
The delay is optional and defaults to immediate execution. Interactive triggers like mentions always execute immediately regardless of delay settings.
Clone the Repository
In order to give meaningful suggestions, the agent needs access to the codebase.1
Add the Clone Repo block
Drag
Clone Repo
onto the canvas and connect it to the trigger.2
Configure dynamic values
- Repository:
{{trigger.repository.name}}
- Branch:
{{trigger.repository.defaultBranch}}
Add the Triage Agent
Now let’s add a developer-style agent that will analyze the issue and suggest a fix directly in the thread — without making any code changes. We are using theAgent Run
block to run the agent. This is a simple “task” block that will not listen to comments or keep the session open.
The developer can easily communicate with the agent by mentioning the agent in the issue thread and triggering the “mention” Use Case.
1
Add the Agent Run block
Drag
agent.run
to the canvas and connect it after the Clone Repo
step.2
Assign the Developer Agent
Use an engineering persona capable of reasoning through bugs, such as
Developer
or a custom BugTriage
agent.3
Write the triage instructions
Use this prompt:
Test the Workflow
1
Create a bug issue
Open a new issue in your connected repo with a clear description of a bug.
2
Add the bug label
Apply the
bug
label to trigger the workflow.3
Check the agent’s reply
Within seconds, Overcut should post a response comment that summarizes the bug, explains what the agent found, and mentions the issue author with a suggested fix.
No pull request or code change is made — the developer or author stays in control of the next step.
Expand the Flow
1
Escalate unresolvable bugs
If the agent is unsure or unable to propose a fix, route the issue to a triage board or tag a specific team.
2
Add a notification step
Notify the assignee or team lead that a bug triage comment has been posted.
3
Track resolution status
Use metadata or follow-up automation to detect whether the suggestion was accepted or resolved.
✅ Success Checklist
- Workflow triggers when a bug label is added
- Agent clones and analyzes the repo
- A triage response is posted in the issue thread
- The issue author is mentioned and prompted to confirm next steps
Next Steps
Now that you’ve built a bug triage workflow, explore these related topics:- Agent Run Action: Learn more about single-agent execution for simple tasks
- Agent Session Action: Understand multi-agent coordination for complex workflows
- Git Clone Action: Configure repository cloning options
- Agent Differences: Choose the right action type for your use case