From 40a6367d4bcfbd7c108da76e379aec5c3c395f05 Mon Sep 17 00:00:00 2001
From: Jon Ayers <jon@coder.com>
Date: Mon, 21 Jul 2025 18:55:16 +0200
Subject: [PATCH] chore: update CLAUDE.md to discourage time.Sleep (#18967)

---
 CLAUDE.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/CLAUDE.md b/CLAUDE.md
index 8b7fff63ca..3de33a5466 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