Skip to content

docs: correct subagent nesting default (reversed in 2.1.219) and stale Algorithm LATEST pointer #1655

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
elhoim wants to merge 2 commits into from
+5 −2
Closed

docs: correct subagent nesting default (reversed in 2.1.219) and stale Algorithm LATEST pointer #1655

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
bc819f1
docs(delegation): correct subagent nesting default and add session caps
elhoim Jul 26, 2026
e0fc752
docs(algorithm): correct stale LATEST pointer in the resolution table
elhoim Jul 26, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion LifeOS/install/LIFEOS/DOCUMENTATION/Algorithm/AlgorithmSystem.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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` |
Expand Down
5 changes: 4 additions & 1 deletion LifeOS/install/LIFEOS/DOCUMENTATION/Delegation/DelegationSystem.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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:**
Expand Down