Before you turn them on
Make sure the basics are in place:- source control is connected for PR and repository automations
- Slack is connected for automations that post updates to channels
- Roomote has at least one healthy environment for the repositories it should work in
- the team knows where automation output will appear
Pull request automations
These automations react to pull requests and repository state.
For Review Code, decide whether Roomote should review new commits
automatically and whether draft pull requests should be included. If your team
treats drafts as active collaboration, include them. If drafts are noisy or
half-formed, keep them out until they are ready.
For Resolve PR Conflicts, pick a schedule, PR age cap, and label. The
label is the team-controlled opt-in for scheduled scans. Make sure the label
exists in your repositories, add it to PRs where you want Roomote to attempt
conflict resolution, and remove it when a human should handle the conflict
instead. Roomote only tries this on labeled PRs that are still active, and it
skips PRs older than the age cap you set.
Channel automations
The channel section starts with Auto-respond to channels. Use it to let Roomote start a task from new top-level messages in selected Slack or Discord channels, even when nobody mentions Roomote directly. You can add multiple channels across both providers, and each one can include its own optional instructions and launch criteria. Good first examples:#ask-engineering#bugs#support-inbound#ops-requests
- On Discord, messages from people who have not linked their Discord account to Roomote do not start tasks; Roomote sends them a direct message explaining how to link instead.
- Messages posted by other bots or webhooks (for example a deploy or alert feed) can start tasks too. Use launch criteria to keep noisy feeds in check — for example, only launching on new or worsening alerts.
Manager automations
The manager section controls the shared Manager Channel plus recurring manager-facing updates and suggestions.
Set Automation output first. This is the shared Slack channel for
manager-facing posts, suggestions, summaries, and setup alerts. Invite Roomote
to that channel before you save it.
Each automation card shows a Reports to line with the destination the next
run will use and which setting produced it. Reports go to the automation’s own
channel when one is set, otherwise to the shared Manager Channel. When Slack
is not connected at all, reports fall back automatically to your primary
Microsoft Teams conversation, the configured Telegram chat, or the configured
Discord channel (see
Communications for connecting those
surfaces).
Cards also show capability badges for what each automation supports today:
the chat surfaces it can report to and the source-control providers it works
with. Triage Dependabot Alerts, Triage CodeQL Alerts, and CI Failure Triage are
GitHub-only by nature. Security Auditor, Code Quality Auditor, Weekly Manager
Stats, Suggest Ideas, Summarize Merged PRs, and Triage Sentry Issues work with
any connected source-control provider. Resolve PR Conflicts supports GitHub,
GitLab, and Azure DevOps.
Code Quality Auditor inspects recently merged PR diffs and only posts
high-confidence maintainability issues worth a real follow-up task. It is
meant to catch confusing abstractions, file bloat, brittle branching, and other
quality regressions, not correctness bugs or security issues.
Triage Sentry Issues scans connected Sentry projects and posts the issues
that look worth engineering follow-up. Leave project slugs blank to scan
everything available to the configured token, or scope it to specific
projects.
Triage Dependabot Alerts scans open GitHub Dependabot alerts across your
active repositories and suggests tightly scoped follow-up update tasks. It
does not open PRs directly from the scheduled scan.
Triage CodeQL Alerts scans open GitHub code-scanning alerts (especially
CodeQL findings) across your active repositories and launches tightly scoped
remediation follow-up tasks. It does not open PRs directly from the scheduled
scan.
Security Auditor reviews recently merged PRs for concrete security issues
and secure-by-default gaps that are worth a real follow-up task.
CI Failure Triage reacts the moment a CI workflow run fails on a
repository’s default branch. When a failure persists (it is not already fixed
by a newer run and is not a one-off flake), Roomote starts a fix task that
reproduces the failing job inside the repository’s configured environment,
finds the root cause, opens a PR with the fix, and posts one summary to the
Manager Channel when it finishes. Only repositories that belong to a
configured Roomote environment are triaged.
Add instructions to reduce noise
Several automations include an Additional instructions field. Use it to tell Roomote what good signal looks like for your team. Helpful instructions are specific:Run an automation now
Some automations include a Run now action. Use it when you want to test the current configuration before waiting for the next scheduled run. After you run one, check the destination channel and the task view. A healthy automation should leave enough context for a reviewer to understand why Roomote posted and what should happen next. If the automation creates a task, review the same evidence you would review for manual work: transcript, logs, diffs, previews, artifacts, and final summary.Use Slack workflows for custom triggers
For workflows that are specific to your team, use Slack’s own workflow builder and end the workflow with a Roomote mention. Good custom triggers include:- send new bug-channel posts to Roomote for triage
- turn operational requests from another system into Roomote tasks
- ask Roomote to gather diagnostics when a support escalation arrives
Possible issues
- Nothing posts to Slack. Check that Slack is connected, Roomote is invited to the Manager Channel, and the automation is enabled.
- Suggestions are too broad. Add narrower instructions about what to prioritize and what to ignore.
- Review Code comments on too much. Turn off draft PR review or adjust when automatic reviews run.
- Conflict resolution starts on the wrong PRs. Use the configured label as the opt-in boundary and remove it from PRs that need human handling.