From 16a68218c3a8ccc48b04d551ce26f6179f7d4e62 Mon Sep 17 00:00:00 2001 From: Jammy2211 Date: Tue, 3 Nov 2026 15:43:22 +0000 Subject: [PATCH] docs: shift-brief usage caps max-workers / max-sessions (phase 3a) Co-Authored-By: Claude Opus 5.5 --- batches/AGENTS.md | 7 +++++++ batches/examples/shift_brief_example.md | 2 ++ 2 files changed, 9 insertions(+) diff --git a/batches/AGENTS.md b/batches/AGENTS.md index fd9eaeb1a..161be1d82 100644 --- a/batches/AGENTS.md +++ b/batches/AGENTS.md @@ -198,6 +198,8 @@ only while a brief is open (`policy/shift_watcher.md`). - lanes: any local-dev ral # any subset of: any local-dev ral gpu wsl-data - merge-cap: 3 # unattended glance merges this shift, at most - token-budget: # tokens the shift may spend, all sessions + - max-workers: 2 # optional: concurrent workers (default 2) + - max-sessions: 6 # optional: sessions this shift, all told (default 6) - ral-allowance: # only when lanes includes ral; phase 5 consumes it - packets: 2 - partition: ral @@ -210,6 +212,11 @@ batch constraint; `scoped` — only prompts matching the `scoped:` epics, tags o tiers. `exclude:` removes prompt paths or epics from either dip. Backlog the brief does not cover is **never** dipped. +`max-workers:` and `max-sessions:` are the watcher's usage caps (phase 3a, +`PyAutoBrain/agents/conductors/batch/_orchestrator.py`): at a cap it stops +spawning and records the refusal. Omitted, they default to 2 and 6; a value that +is not a whole number refuses the brief. + **Calibration rule.** A new brief is not accepted while the previous record lacks `review-minutes-actual:`. The planned figure is a seed; the 2026-08-31 record never closed it, and an estimate nobody measures never improves. diff --git a/batches/examples/shift_brief_example.md b/batches/examples/shift_brief_example.md index c78f2809e..15ef8bae5 100644 --- a/batches/examples/shift_brief_example.md +++ b/batches/examples/shift_brief_example.md @@ -26,6 +26,8 @@ - lanes: any local-dev ral - merge-cap: 3 - token-budget: 2000000 + - max-workers: 2 + - max-sessions: 6 - ral-allowance: - packets: 2 - partition: ral