> ## Documentation Index
> Fetch the complete documentation index at: https://docs.newmote.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Roll out Roomote to your team

> Keep the first rollout small, visible, and easy to evaluate.

Use this guide when you are past basic setup and want the first rollout to feel credible instead of noisy.

The goal is to make Roomote useful in one real workflow before you expand it across more teams, repositories, or automations.

## Start with one team-shaped slice

Pick a narrow slice of work that already happens often:

* a shared Slack channel where bugs or questions show up
* one product surface with a clear repository owner
* a support or ops workflow that needs faster investigation
* a PR review or cleanup pattern that keeps repeating

Avoid starting with every repository and every integration at once.

## What a good first rollout looks like

<Steps>
  <Step title="Connect the core workflow">
    Set up GitHub and Slack first. They give Roomote both repository access and
    a shared place for the team to see work happen.
  </Step>

  <Step title="Create one solid environment">
    Make sure the first environment can run, verify, or preview real work. That
    matters more than having many environments on day one.
  </Step>

  <Step title="Use real asks, not demo asks">
    Start with questions, bugs, chores, and review follow-up your team already
    has, not synthetic showcase prompts.
  </Step>

  <Step title="Review the task output openly">
    Open the task view, inspect the evidence, and show the team what Roomote did
    well and where it still needed help.
  </Step>

  <Step title="Expand after the first visible wins">
    Add more repositories, integrations, or automations only after the core path
    feels stable.
  </Step>
</Steps>

## Good pilot tasks

* explain a code path that keeps interrupting engineers
* investigate a failing preview or flaky test
* apply a small UI or copy fix
* review a PR for regressions
* turn an issue into a scoped implementation plan

## Signs you can expand

Expand the rollout when the team can already do these without confusion:

* choose the right environment
* start tasks from the normal workflow surface
* review the task output in the dashboard
* decide whether the result should be merged, revised, or kept as a plan

## Common rollout mistakes

* starting with too many repositories or environments
* treating the first rollout like a feature tour instead of a real workflow
* asking Roomote for work that is too broad to verify cleanly
* hiding the review step instead of showing teammates how to inspect the task