From a29d87f384aa807b1e5de9f3ec537073cd33f0ae Mon Sep 17 00:00:00 2001
From: JackChen <jack_ai@qq.com>
Date: Tue, 7 Apr 2026 10:46:08 +0800
Subject: [PATCH] docs: update CLAUDE.md concurrency section for per-agent
 mutex

---
 CLAUDE.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CLAUDE.md b/CLAUDE.md
index 6cbeb45..7a74bdb 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -55,7 +55,7 @@ This is the framework's key feature. When `runTeam()` is called:
 
 ### Concurrency Control
 
-Two independent semaphores: `AgentPool` (max concurrent agent runs, default 5) and `ToolExecutor` (max concurrent tool calls, default 4).
+Three semaphore layers: `AgentPool` pool-level (max concurrent agent runs, default 5), `AgentPool` per-agent mutex (serializes concurrent runs on the same `Agent` instance), and `ToolExecutor` (max concurrent tool calls, default 4).
 
 ### Structured Output