zulip-platform-plugins/docs/adr/ADR-006-all-bots-model.md

ADR 6: @all-bots via Dedicated Zulip Bot User

Date: 2026-04-28

Decision

@all-bots is implemented as a dedicated Zulip bot user with display name All Bots and email all-bots@chat.sysloggh.net. All 6 per-agent bots subscribe to the same event narrow and detect when All Bots is in mentioned_users.

Context

@all-bots needs to trigger all agents regardless of platform. A dedicated bot user is explicit and intentional — it prevents @everyone or stream-wide pings from accidentally triggering all agents. Each bot independently detects the @mention and forwards to its agent.

Consequences

• Must create a 7th Zulip bot user for All Bots
• Each agent bot's config must include All Bots user ID for detection
• @all-bots is opt-in: only topics that explicitly @all-bots trigger broadcast
• Cross-platform broadcast works without a central dispatcher