zulip-platform-plugins/docs/adr/ADR-003-agent-naming.md

ADR 3: Agent Naming Convention

Date: 2026-04-28

Decision

Each agent bot has a display name in {name}-bot format with no spaces, dashes only: tanko-bot, mumuni-bot, koonimo-bot, koby-bot, kagentz-bot, abiba-bot.

Context

Zulip @mentions work best with clean, predictable names. No spaces avoids ambiguity in @mention parsing. The -bot suffix makes it clear these are automated agents, not human users.

Consequences

• @mention format: @**tanko-bot**
• Email format: tanko-bot@chat.sysloggh.net
• Users must type @tanko-bot (not @tanko)
• Consistent naming across all 6 agents