diff --git a/CLAUDE.md b/CLAUDE.md
index 8b7fff63ca12f..3de33a5466054 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -107,6 +107,11 @@ app, err := api.Database.GetOAuth2ProviderAppByClientID(ctx, clientID)
- Full suite: `./scripts/oauth2/test-mcp-oauth2.sh`
- Manual testing: `./scripts/oauth2/test-manual-flow.sh`
+### Timing Issues
+
+NEVER use `time.Sleep` to mitigate timing issues. If an issue
+seems like it should use `time.Sleep`, read through https://github.com/coder/quartz and specifically the [README](https://github.com/coder/quartz/blob/main/README.md) to better understand how to handle timing issues.
+
## 🎯 Code Style
### Detailed guidelines in imported WORKFLOWS.md
pFad - Phonifier reborn
Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.
Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.
Alternative Proxies:
Alternative Proxy
pFad Proxy
pFad v3 Proxy
pFad v4 Proxy