From bc819f132665aacf1394380e048b9adabe8a67ff Mon Sep 17 00:00:00 2001 From: elhoim Date: Sun, 26 Jul 2026 17:07:01 +0000 Subject: [PATCH 1/2] docs(delegation): correct subagent nesting default and add session caps The nesting default has moved twice in three releases: 5 until 2.1.217, 1 in 2.1.217, and 3 from 2.1.219. Guidance stating that subagents cannot spawn subagents steers away from a pattern the platform now enables by default. Record the current depth-3 default with the flag to flatten it, and add the two per-session ceilings (200 subagent spawns, 200 WebSearch calls) that a long fan-out session can actually reach. Wording on the concurrency cap stays neutral on what happens to over-cap spawns, per the note on #1569 that the changelog does not state whether they queue or are refused. --- .../LIFEOS/DOCUMENTATION/Delegation/DelegationSystem.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/LifeOS/install/LIFEOS/DOCUMENTATION/Delegation/DelegationSystem.md b/LifeOS/install/LIFEOS/DOCUMENTATION/Delegation/DelegationSystem.md index 10a4796738..2ae084aec2 100755 --- a/LifeOS/install/LIFEOS/DOCUMENTATION/Delegation/DelegationSystem.md +++ b/LifeOS/install/LIFEOS/DOCUMENTATION/Delegation/DelegationSystem.md @@ -64,7 +64,10 @@ Agent({ prompt: "System design / distributed systems. Design the distributed cac Use the Agents skill to compose task-specific agents with unique traits, voices, and expertise: - Use a SINGLE message with MULTIPLE Agent tool calls - Each agent gets FULL CONTEXT and DETAILED INSTRUCTIONS via ComposeAgent prompt -- Launch as many as needed (no artificial limit) +- Launch as many as the work needs, but design around the runtime ceilings (Claude Code 2.1.219+): + - **Concurrency caps at 20 running subagents** — raise with `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS`. The changelog states the cap but not what happens to spawns above it, so don't build a fan-out that assumes either queueing or refusal: keep concurrent dispatches at or under the cap, or raise it deliberately. + - **200 subagent spawns per session**, and **200 WebSearch calls per session** — `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` and `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION`. Long multi-fan-out sessions can reach these; a denied spawn late in a session usually means the session budget, not the concurrency cap. + - **Subagents nest to depth 3 by default.** A subagent may spawn its own subagents two levels further down. Set `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1` to flatten delegation back to a single tier. (This default has moved twice: 5 until 2.1.217, 1 in 2.1.217–2.1.218, 3 from 2.1.219 — check the installed version before relying on a specific depth.) - **ALWAYS launch a spotcheck agent after parallel work completes** **Agent routing by task type:** From e0fc7526df73b9a3bd45fb83ee4e1d19948de725 Mon Sep 17 00:00:00 2001 From: elhoim Date: Sun, 26 Jul 2026 17:14:54 +0000 Subject: [PATCH 2/2] docs(algorithm): correct stale LATEST pointer in the resolution table MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The row that teaches how to resolve the Algorithm version named 8.1.0 while ALGORITHM/LATEST reads 8.4.0 — three versions of drift in the one place a reader looks up the answer. Line 26 of the same file was already correct, so this was a single missed edit rather than a systemic lag. (cherry picked from commit deac16f07712064d9e6464e885c73863e98560e2) --- .../install/LIFEOS/DOCUMENTATION/Algorithm/AlgorithmSystem.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/LifeOS/install/LIFEOS/DOCUMENTATION/Algorithm/AlgorithmSystem.md b/LifeOS/install/LIFEOS/DOCUMENTATION/Algorithm/AlgorithmSystem.md index 67e7646acc..f806812684 100644 --- a/LifeOS/install/LIFEOS/DOCUMENTATION/Algorithm/AlgorithmSystem.md +++ b/LifeOS/install/LIFEOS/DOCUMENTATION/Algorithm/AlgorithmSystem.md @@ -34,7 +34,7 @@ Spend follows the work, discovered from the task and its evidence gates — neve |---|---|---| | System prompt | Constitution: modes, output contracts, security, verification doctrine | `LIFEOS/LIFEOS_SYSTEM_PROMPT.md` | | Dynamic context | CLAUDE.md routing table, @-imports, hook-injected session context | `DOCUMENTATION/Config/ConfigSystem.md` | -| The Algorithm file | The done-claims — what a completed run must satisfy | `ALGORITHM/v${LATEST}.md` (resolve `ALGORITHM/LATEST`; currently 8.1.0) | +| The Algorithm file | The done-claims — what a completed run must satisfy | `ALGORITHM/v${LATEST}.md` (resolve `ALGORITHM/LATEST`; currently 8.4.0) | | ISA | The artifact: done as falsifiable claims | `DOCUMENTATION/Isa/IsaSystem.md` + `IsaFormat.md` | | Hooks | Mechanical enforcement (the teeth that don't decay) | `DOCUMENTATION/Hooks/HookSystem.md` | | Pulse | The instruments | `DOCUMENTATION/Pulse/PulseSystem.md` |