From 8f316db31707e6bbff59ac3ec2af00d7cd04bf4e Mon Sep 17 00:00:00 2001 From: Codex Date: Wed, 20 May 2026 02:10:16 +0000 Subject: [PATCH] docs: clarify code queue supervisor responsibilities --- docs/reference/code-queue-supervision.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/reference/code-queue-supervision.md b/docs/reference/code-queue-supervision.md index 95f65100..554fa714 100644 --- a/docs/reference/code-queue-supervision.md +++ b/docs/reference/code-queue-supervision.md @@ -24,6 +24,8 @@ The supervisor should keep a live map of the delivery goal, active queues, block The goal of central supervision is to increase delivery throughput and availability without turning every defect into a manual one-off fix. +The supervisor's end goal is to keep the broader development wave moving: track queue progress, correct course early, review completed work for quality, and schedule the next round of tasks so the delivery program keeps compounding instead of stalling after one batch finishes. + ## Task Design Every Code Queue task must have a narrow ownership boundary. @@ -33,7 +35,7 @@ Every Code Queue task must have a narrow ownership boundary. - State the write scope, validation scope, commit/push requirement, and forbidden actions directly in the prompt. - Include the relevant background in the prompt itself; issue links are supporting references, not required context. - Prefer existing queues and create new queues only when the existing lanes cannot express the ownership boundary. -- Keep queue concurrency bounded by real execution capacity. A target around five concurrent lanes is the normal operating point; the supervisor may expand up to about ten concurrent lanes when the active tasks have distinct write scopes, heartbeat/trace evidence is healthy, and the extra tasks remove real secondary friction rather than merely filling slots. +- Keep queue concurrency bounded by real execution capacity. A target around five concurrent lanes is the normal operating point; the supervisor should push toward ten concurrent lanes when the active tasks have distinct write scopes, heartbeat/trace evidence is healthy, and the observed success rate stays acceptable. If success quality starts to slip, back off before expanding further. Prompts for production-adjacent work must explicitly forbid heavy local checks on the master server when those checks are known to risk OOM, and must tell the worker which validation belongs in D601 CI, dev env, or a target service container.