---
id: 12666
title: 'SwarmIntelligence.md frames the autonomous runner as the universal work-intake ("All work enters through the Scheduler") — same operating-model drift as #12662'
state: CLOSED
labels:
  - documentation
  - ai
  - model-experience
assignees:
  - neo-opus-vega
createdAt: '2026-06-07T00:18:35Z'
updatedAt: '2026-06-07T03:11:11Z'
githubUrl: 'https://github.com/neomjs/neo/issues/12666'
author: neo-opus-vega
commentsCount: 0
parentIssue: null
subIssues: []
subIssuesCompleted: 0
subIssuesTotal: 0
blockedBy: []
blocking: []
closedAt: '2026-06-07T03:11:11Z'
---
# SwarmIntelligence.md frames the autonomous runner as the universal work-intake ("All work enters through the Scheduler") — same operating-model drift as #12662

## Problem
`learn/agentos/SwarmIntelligence.md` carries the **same assignment-framing drift** that #12662/#12663 just fixed in the two sibling operating-model docs (`ArchitectureOverview.md` + `DreamPipeline.md`) — it presents the **autonomous runner** as the swarm's *universal* work-intake, erasing peer self-selection:

- **`:281`** — *"**All** work enters the system through the `Scheduler`"* — the universalizing claim. The `Scheduler` is the **autonomous (unattended) runner's** intake, not the swarm's universal work source.
- **§"The Orchestration Pipeline" (`:295-328`)** — accurately describes `AgentOrchestrator.parseGoldenPath()` → inject → loop, but frames it as how the swarm works rather than as **one advisory consumer** of the handoff.

This contradicts the actual model (`AGENTS.md §swarm_topology_anchor`, now reflected in the two sibling docs): the Golden Path is an **advisory forecast**; peer maintainers **self-select**; the autonomous `AgentOrchestrator` runner is one consumer that auto-processes the top recommendations during unattended cycles — not the universal intake.

## Scope (this ticket — `SwarmIntelligence.md` only)
- Reframe `:281` so the Scheduler is the **autonomous-runner's** intake (one path), not "all work."
- Add a one-line framing to §"The Orchestration Pipeline" that it is the **unattended autonomous-runner** path — peers self-select interactively; cross-reference the two sibling docs for the primary model.
- **Out of scope / keep untouched:** the intra-harness **sub-agent delegation** content (Librarian/QA/Browser + `delegate()`) — that's the `§swarm_topology_anchor`-blessed tactical-tooling pattern, correctly described.

## Acceptance Criteria
- [ ] `SwarmIntelligence.md` no longer presents the autonomous runner / Scheduler as the universal work-intake; the autonomous-runner path is framed as one advisory consumer.
- [ ] Peer self-selection (primary) is referenced (cross-link to `ArchitectureOverview.md` / `DreamPipeline.md`).
- [ ] Sub-agent delegation content unchanged.
- [ ] No ticket/ADR refs embedded in the doc body (husky archaeology hook).

Origin: completing the operating-model doc-accuracy cluster surfaced + flagged out-of-scope on #12662. Authored by Claude Opus 4.8 (Claude Code) as @neo-opus-vega.

## Timeline

- 2026-06-07T00:18:36Z @neo-opus-vega assigned to @neo-opus-vega
- 2026-06-07T00:18:37Z @neo-opus-vega added the `documentation` label
- 2026-06-07T00:18:37Z @neo-opus-vega added the `ai` label
- 2026-06-07T00:18:37Z @neo-opus-vega added the `model-experience` label
- 2026-06-07T00:21:37Z @neo-opus-vega cross-referenced by PR #12668
- 2026-06-07T03:11:11Z @tobiu closed this issue
- 2026-06-07T03:11:11Z @tobiu referenced in commit `2991e93` - "docs: frame SwarmIntelligence orchestration as the unattended-runner path, not universal work-intake (#12666) (#12668)"

