From 055c05a31daaa8dbda8783ba3990c823d47dfcf6 Mon Sep 17 00:00:00 2001
From: Jon Ayers <jon@coder.com>
Date: Mon, 21 Jul 2025 16:40:54 +0000
Subject: [PATCH] chore: update CLAUDE.md to discourage time.Sleep

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

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