From 334b80f65e822d72e18efb6ad195611d61fe84f4 Mon Sep 17 00:00:00 2001 From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com> Date: Sun, 25 Oct 2026 03:37:53 -0700 Subject: [PATCH 1/2] docs(agents): pod size and goal, the fleet rule Sam set 10-25 (TASK-526) Five rules: a working pod holds at most 5 agents, gates and leads included; a seat may sit in several pods; the coordination room holds lead seats only; every working pod opens with a pinned goal, a done condition and an owner; a pod that meets its done condition posts its result to the coordination room and is archived, which keeps membership and history. One line names the cost driver: wake fan-out, not membership. The pointer to the sub-pod ADR is added by the PR that opens it (TASK-533), since that ADR is not on main yet. Co-Authored-By: Claude Opus 5.5 Co-authored-by: wren Agent-Model: claude/claude-opus-5-5/max --- docs/agents/pod-size-and-goal.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) create mode 100644 docs/agents/pod-size-and-goal.md diff --git a/docs/agents/pod-size-and-goal.md b/docs/agents/pod-size-and-goal.md new file mode 100644 index 0000000000..7a21326c7f --- /dev/null +++ b/docs/agents/pod-size-and-goal.md @@ -0,0 +1,13 @@ +# Pod size and goal + +**Fleet rule, set by Sam on 2026-10-25.** It applies to every working pod in the fleet. + +1. **A working pod holds at most 5 agents,** gates and leads included. Past 5, split it or open a sub-pod. +2. **A seat may sit in several pods.** Gate seats usually do. +3. **The coordination room is the one exception.** It holds lead seats only. +4. **Every working pod opens with a pinned one-line goal, a done condition and an owner,** its lead seat. Work outside the goal goes to another pod or to a new one. +5. **When the done condition is met, the pod posts its result to the coordination room and is archived.** Archiving keeps membership and history. + +**The cost driver is wake fan-out, not membership.** A seat costs a turn only when something wakes it (a mention, a board wake, a message in a pod that wakes on messages), so a small pod with one goal wakes fewer seats per message and per row edit. + +This is a fleet operating rule, not a product limit. From ddd19db6625c91435b18ea2b62f0fa1fbedc467b Mon Sep 17 00:00:00 2001 From: Lily Shen <115414357+lilyshen0722@users.noreply.github.com> Date: Sun, 25 Oct 2026 04:03:17 -0700 Subject: [PATCH 2/2] docs(agents): scope the pod-size cost line to what pod size changes (TASK-526) The cost line listed three wake sources as if they were the only ones. It now says what membership alone costs: a digest delivery starts no turn, and unread digest gets at most one heartbeat after an hour with no other wake (ADR-018 D9.1). Pod size changes fan-out, meaning how many seats one message or one row edit can wake. Co-Authored-By: Claude Opus 5.5 Co-authored-by: wren Agent-Model: claude/claude-opus-5-5/max --- docs/agents/pod-size-and-goal.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/agents/pod-size-and-goal.md b/docs/agents/pod-size-and-goal.md index 7a21326c7f..499a4b9960 100644 --- a/docs/agents/pod-size-and-goal.md +++ b/docs/agents/pod-size-and-goal.md @@ -8,6 +8,6 @@ 4. **Every working pod opens with a pinned one-line goal, a done condition and an owner,** its lead seat. Work outside the goal goes to another pod or to a new one. 5. **When the done condition is met, the pod posts its result to the coordination room and is archived.** Archiving keeps membership and history. -**The cost driver is wake fan-out, not membership.** A seat costs a turn only when something wakes it (a mention, a board wake, a message in a pod that wakes on messages), so a small pod with one goal wakes fewer seats per message and per row edit. +**The cost driver is wake fan-out, not membership.** A message delivered as digest starts no turn, and unread digest gets at most one heartbeat after an hour with no other wake ([ADR-018 D9.1](../adr/ADR-018-agent-attention-claims.md)). What pod size changes is fan-out: how many seats one message or one row edit can wake. This is a fleet operating rule, not a product limit.