diff --git a/CLAUDE.md b/CLAUDE.md
index 977d34a..0249008 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -7,6 +7,12 @@ Bifrost is a fully accessible fediverse client built with PySide6, designed spec
 - Check for any changes in git project before doing anything else. Make sure the latest changes have been pulled
 - See what has changed, use git commands and examine the code to make sure you are up to date with the latest code
 
+## Documentation and Dependencies
+- **README Updates**: When adding new functionality or sound events, update README.md with detailed descriptions
+- **Requirements Management**: Check and update requirements.txt when new dependencies are added
+- **Sound Pack Documentation**: Document new sound events in both CLAUDE.md and user-facing documentation
+- **Version Tracking**: Update version numbers and changelog when significant features are added
+
 ## Core Features
 - Full ActivityPub protocol support (Pleroma and GoToSocial primary targets)
 - Threaded conversation navigation with collapsible tree view
diff --git a/README.md b/README.md
index 2227023..5e91e57 100644
--- a/README.md
+++ b/README.md
@@ -137,6 +137,8 @@ Your sound pack should include audio files for these events:
 - `post_sent` - User successfully posted
 - `timeline_update` - New posts in timeline
 - `notification` - General notification
+- `autocomplete` - Autocomplete suggestions available (optional)
+- `autocomplete_end` - Autocomplete interaction ended (optional)
 - `startup` - Application started (optional)
 - `shutdown` - Application closing (optional)
 - `expand` - Thread expanded (optional)
@@ -162,6 +164,8 @@ Create a `pack.json` file with this format:
     "post_sent": "sent.wav",
     "timeline_update": "update.wav",
     "notification": "notification.wav",
+    "autocomplete": "autocomplete.wav",
+    "autocomplete_end": "autocomplete_end.wav",
     "startup": "startup.wav",
     "shutdown": "shutdown.wav",
     "expand": "expand.wav",