Skip to content

[Docs] Add cloud agent adoption recipe - #1064

Merged
brunobergher merged 2 commits into
developfrom
feature/ease-team-cloud-agents-3lb13hmz2uvrz
Aug 4, 2026
Merged

[Docs] Add cloud agent adoption recipe#1064
brunobergher merged 2 commits into
developfrom
feature/ease-team-cloud-agents-3lb13hmz2uvrz

Conversation

@roomote-roomote

@roomote-roomote roomote-roomote Bot commented Aug 3, 2026

Copy link
Copy Markdown
Contributor

Created by Roomote. Follow up by mentioning @roomote-roomote, in the web UI, or in Slack.

What changed

Added a Cookbook recipe for introducing cloud agents through simple, low-risk team habits. It covers leader-led examples in #factory, codebase questions in #ask-roomote, direct custom emoji reactions, Review Code for engineer-authored PRs, read-only starter tasks, public feedback loops, and private rehearsal.

The recipe is attributed to Bruno Bergher and appears in the generated Cookbook index without being added to the sidebar. Contributor guidance now makes that navigation exception explicit, and the generator uses deterministic English title sorting.

Why this change was made

Teams may hesitate to use cloud agents in public before they understand how the work is started, reviewed, and corrected. This recipe gives installers and team leads a small adoption ladder that builds familiarity before adding autonomy.

Impact

Docs readers now have a copyable, adoption-focused playbook for helping engineers build trust in Roomote without beginning with complex automations or code-changing tasks. Future recipes follow a documented file-plus-generator workflow and remain discoverable through the alphabetized index rather than crowding the sidebar.

Screenshots

The Cookbook sidebar excludes individual recipe pages while the generated table lists all recipes in alphabetical title order.

The recipe accurately frames custom emoji reactions as a direct Roomote ask and names the Review PRs not created by Roomote toggle.

@roomote-community

roomote-community Bot commented Aug 3, 2026

Copy link
Copy Markdown
Contributor

1 issue outstanding. See task

  • apps/docs/cookbook/ease-your-team-into-cloud-agents.mdx:31Custom Emoji Reaction is not a configurable Roomote automation. The recipe tells readers to add and enable it, so this adoption path cannot be followed; replace it with an existing feature/workflow or document the actual setup.
  • apps/docs/cookbook/ease-your-team-into-cloud-agents.mdx:48 — Simply enabling Review Code does not review PRs opened by people: reviewAllPullRequestAuthors defaults to false. Tell readers to enable Review PRs not created by Roomote as well, otherwise the recommended human-PR review stage never runs.
  • apps/docs/cookbook/ease-your-team-into-cloud-agents.mdx:83 — The reaction prompt says the target message is “linked below,” but no message link or placeholder follows. The supported action needs the Slack channel and message timestamp, so this copyable prompt cannot be completed as written; include a Slack message permalink or an explicit placeholder for one.

Reviewed 975999b

@roomote-roomote

roomote-roomote Bot commented Aug 4, 2026

Copy link
Copy Markdown
Contributor Author

Updated in 975999b: removed the recipe from sidebar navigation, documented the file-plus-generator Cookbook workflow, pinned deterministic title sorting, and corrected the custom-reaction and Review Code setup guidance. The draft PR body and screenshots now reflect the shipped result.

@brunobergher
brunobergher marked this pull request as ready for review August 4, 2026 10:44
@brunobergher
brunobergher merged commit 74b080d into develop Aug 4, 2026
18 checks passed
@brunobergher
brunobergher deleted the feature/ease-team-cloud-agents-3lb13hmz2uvrz branch August 4, 2026 10:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants