Skip to content

Open-source AI teammates in Slack, Teams, Discord, Telegram and Mattermost. Self-host it, with any agent harness and any model.

docs(connectors): tell agents to answer at the root, not in a new thread (#221)

Louis Amaudruz095067c82fda
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 3ae519b2a..0efcec700 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1462,6 +1462,12 @@ compatibility signal. History for those is in the git log.
### [Unreleased]
+#### Changed
+- The room workflow adds a Mattermost-only rule: post at the root there unless
+ you were asked in a thread. Mattermost shows a threaded reply as a reply count
+ under the original post rather than in the channel, so a first-time reader can
+ take it for no answer. Threading is unchanged everywhere else.
+
### [0.9.2] - 2026-08-14
#### Changed
- The room-workflow skill lists `opencode` alongside `codex` and `claude-code`
@@ -1550,6 +1556,12 @@ manifest history.
### [Unreleased]
+#### Changed
+- The room workflow adds a Mattermost-only rule: post at the root there unless
+ you were asked in a thread. Mattermost shows a threaded reply as a reply count
+ under the original post rather than in the channel, so a first-time reader can
+ take it for no answer. Threading is unchanged everywhere else.
+
### [0.3.3] - 2026-08-14
#### Changed
@@ -1643,6 +1655,12 @@ the app version that wrote it rather than a version of its own.
### [Unreleased]
+#### Changed
+- The room workflow adds a Mattermost-only rule: post at the root there unless
+ you were asked in a thread. Mattermost shows a threaded reply as a reply count
+ under the original post rather than in the channel, so a first-time reader can
+ take it for no answer. Threading is unchanged everywhere else.
+
### [0.1.0] - 2026-08-14
First release. Ships the Switch room-workflow skill, registers the Switch MCP
diff --git a/connectors/claude-code-plugin/skills/switch/SKILL.md b/connectors/claude-code-plugin/skills/switch/SKILL.md
index df52407a8..9a89934b3 100644
--- a/connectors/claude-code-plugin/skills/switch/SKILL.md
+++ b/connectors/claude-code-plugin/skills/switch/SKILL.md
@@ -211,6 +211,11 @@ local operator is explicitly steering you outside the room conversation.
- Threads bridge to and from Mattermost natively, and to Telegram forum
topics. You are only notified of threaded replies that address you; pull the
rest with `read_context`.
+- **Mattermost only — post at the root unless you were asked in a thread.**
+ Mattermost shows a threaded reply as a reply count under the original post
+ rather than in the channel, so the people waiting on you may never see it.
+ `connect_to_room` names the platform a room is bridged to. Everywhere else,
+ thread as described above.
## Sending and receiving attachments
diff --git a/connectors/codex-plugin/skills/switch/SKILL.md b/connectors/codex-plugin/skills/switch/SKILL.md
index 7aa8003ac..d0791d6e6 100644
--- a/connectors/codex-plugin/skills/switch/SKILL.md
+++ b/connectors/codex-plugin/skills/switch/SKILL.md
@@ -217,6 +217,11 @@ local operator is explicitly steering you outside the room conversation.
- Threads bridge to and from Mattermost natively, and to Telegram forum
topics. You are only delivered threaded replies that address you; pull the
rest with `read_context`.
+- **Mattermost only — post at the root unless you were asked in a thread.**
+ Mattermost shows a threaded reply as a reply count under the original post
+ rather than in the channel, so the people waiting on you may never see it.
+ `connect_to_room` names the platform a room is bridged to. Everywhere else,
+ thread as described above.
## Sending and receiving attachments
diff --git a/connectors/opencode-plugin/skills/switch/SKILL.md b/connectors/opencode-plugin/skills/switch/SKILL.md
index 8a3dc7d12..7b3d3ba96 100644
--- a/connectors/opencode-plugin/skills/switch/SKILL.md
+++ b/connectors/opencode-plugin/skills/switch/SKILL.md
@@ -225,6 +225,11 @@ local operator is explicitly steering you outside the room conversation.
- Threads bridge to and from Mattermost natively, and to Telegram forum
topics. You are only delivered threaded replies that address you; pull the
rest with `read_context`.
+- **Mattermost only — post at the root unless you were asked in a thread.**
+ Mattermost shows a threaded reply as a reply count under the original post
+ rather than in the channel, so the people waiting on you may never see it.
+ `connect_to_room` names the platform a room is bridged to. Everywhere else,
+ thread as described above.
## Sending and receiving attachments