docs: link on-demand agent lifecycle doc from README and arch overview [doc-updater]

README.md

@@ -288,7 +288,7 @@ Start with **[docs/index.md](docs/index.md)**, which has task-specific lookup ta
 | **Slice-DAG implement phase** | [Slice-DAG Implement Phase](docs/architecture/slice-dag.md) |
 | **SDLC pipeline** | [SDLC Pipeline Guide](docs/guides/sdlc-pipeline.md) |
 | **Human-in-the-loop decisions** | [HITL Decisions](docs/hitl-decisions.md) |
-| **Orchestrator & overseer** | [Orchestrator Architecture](docs/architecture/orchestrator.md) |
+| **Orchestrator & overseer** | [Orchestrator Architecture](docs/architecture/orchestrator.md) · [On-Demand Agent Lifecycle](docs/architecture/on-demand-agent-lifecycle.md) |
 | **Health monitoring** | [Pipeline Health Monitoring](docs/guides/pipeline-health-monitoring.md) |
 | **Agent roles & permissions** | [Agent Roles Reference](docs/reference/agent-roles.md) |
 | **Non-Claude model routing** | [Upstream Routing](docs/architecture/upstream-routing.md) · [Per-Agent Models](docs/guides/per-agent-models.md) |

docs/architecture/README.md

@@ -53,7 +53,7 @@ See the [main README](../../README.md) for the architecture diagram.
 | **Shared Libraries** | Config, logging, git utilities, orchestrator types | [Shared README](../../shared/README.md) |
 | **egg_contracts** | SDLC contract models, role-based mutation validation, multi-agent orchestration | `shared/egg_contracts/` |
 | **egg_orchestrator** | Shared orchestrator types and sandbox-to-orchestrator communication | `shared/egg_orchestrator/` |
-| **Multi-Agent Orchestration** | Concurrent agent execution (Coder, Tester, Documenter, Reviewers) | `orchestrator/concurrent_executor.py`, `orchestrator/kubernetes_spawner.py` |
+| **Multi-Agent Orchestration** | Concurrent agent execution (Coder, Tester, Documenter, Reviewers) | `orchestrator/concurrent_executor.py`, `orchestrator/kubernetes_spawner.py`, `orchestrator/event_loop.py`, `orchestrator/supervision_policy.py` |
 
 ## SDLC Contracts
 
@@ -148,6 +148,7 @@ The SDLC pipeline orchestrates agent-based development with structurally enforce
 - [Integration-Test Trust Boundary](integration-test-trust-boundary.md) - Test execution contexts (in-sandbox-agent / trusted-CI-runner / human-operator), fixture tier table, and hard-NACK rules for plan-phase Primitive-Existence (§9) and Trust-Boundary (§10) audits
 - [BRC Memory Artifact](brc-memory.md) - Per-role-per-pipeline distilled memory file (`.egg-state/agent-outputs/<role>/brc-memory-<pipeline-id>.md`) written by `brc_ack`/`brc_nack`; schema, three `EGG_BRC_MEMORY` modes, atomic-write contract, fail-closed path constructor, distill-on-write cap at 20, and the role-allowlist coverage that makes the path writable for every participant role ([#2908](https://github.com/jwbron/egg/issues/2908))
 - [BRC Consensus Wrapper](orchestrator.md#brc-consensus-wrapper) - Deterministic event-pump wrapper loop, wrapper-side heartbeat + gateway-session keep-alive subshells, the idle/no-progress safety budget that replaced the 3-restart FAIL cap, and the `git revert` rollback plan after slice-4 deleted the legacy capped-restart template (`_CONSENSUS_WRAPPER_TEMPLATE` / `_RECOVERY_SYSTEM_PROMPT` / SSE `consensus.reached` / `MAX_CONSENSUS_RESTARTS`) and the agent-side heartbeat path. Wait-side companion in [agent-wait-patterns §10](../reference/agent-wait-patterns.md#10-brc-consensus-wrapper-event-pump-model) ([#2908](https://github.com/jwbron/egg/issues/2908))
+- [On-Demand Agent Lifecycle](on-demand-agent-lifecycle.md) - Event-loop ownership modes (`EGG_EVENT_LOOP_OWNER` pod vs orchestrator), the sha256 dedupe-key contract, `JobSupervisor` failure supervision (streak/backoff/alert via shared `supervision_policy.py`), lifecycle-aware monitor matrix, worktree re-attach + session-reuse rules, live proving-run checklist ([#3064](https://github.com/jwbron/egg/issues/3064))
 
 ## Why Wrappers, Not MCP