story-kit: accept 282_story_matrix_bot_ambient_mode_toggle_via_chat_command

.story_kit/work/6_archived/282_story_matrix_bot_ambient_mode_toggle_via_chat_command.md

@@ -0,0 +1,24 @@
+---
+name: "Matrix bot ambient mode toggle via chat command"
+---
+
+# Story 282: Matrix bot ambient mode toggle via chat command
+
+## User Story
+
+As a user chatting with Timmy in a Matrix room, I want to toggle between "addressed mode" (bot only responds when mentioned by name) and "ambient mode" (bot responds to all messages) via a chat command, so that I don't have to @-mention the bot on every message when I'm the only one around.
+
+## Acceptance Criteria
+
+- [ ] Matrix bot defaults to addressed mode — only forwards messages containing the bot's name to Claude
+- [ ] Chat command "{bot_name} ambient on" switches to ambient mode — bot forwards all room messages to Claude (bot name comes from display_name in bot.toml)
+- [ ] Chat command "{bot_name} ambient off" switches back to addressed mode
+- [ ] Mode is persisted per-room in bot.toml so it survives bot restarts
+- [ ] bot.toml.example includes the ambient_mode setting with a comment explaining it
+- [ ] Bot confirms the mode switch with a short response in chat
+- [ ] When other users join or are active, user can flip back to addressed mode to avoid noise
+- [ ] Ambient mode applies per-room (not globally across all rooms)
+
+## Out of Scope
+
+- TBD